Android Upgrade Party สำหรับการอัปเดตระบบปฏิบัติการ

Upgrade Party คือโฟลว์การค้นพบที่ไฮไลต์ฟีเจอร์ใหม่สำหรับผู้ใช้ Android ทุกครั้งที่ได้รับการอัปเกรดระบบปฏิบัติการครั้งสำคัญ

การอัปเกรดระบบปฏิบัติการ Android ครั้งสำคัญอาจเป็นประสบการณ์ที่ไม่น่าประทับใจสำหรับผู้ใช้ โฟลว์ Upgrade Party จะเพิ่มการมีส่วนร่วมของผู้ใช้และช่วยให้ผู้ใช้เข้าใจวิธีใช้งานระบบปฏิบัติการที่รีเฟรชใหม่

หลังจากอัปเกรดเป็นระบบปฏิบัติการเวอร์ชันล่าสุดแล้ว ผู้ใช้จะได้รับการแจ้งเตือนแบบพุชเพื่อต้อนรับเข้าสู่ระบบปฏิบัติการใหม่และแสดงโฟลว์การ์ดพร้อมฟีเจอร์ใหม่

ผู้ผลิตอุปกรณ์สามารถเปิดใช้ Upgrade Party สำหรับอุปกรณ์ระบบปฏิบัติการ Android ได้โดยส่ง แบบฟอร์มคำขอเปิดใช้งาน Android Upgrade Party

ปรับแต่งประสบการณ์การใช้งาน Upgrade Party

คุณปรับแต่งประสบการณ์การใช้งาน Upgrade Party ได้ด้วยวิธีต่อไปนี้

• นำฟีเจอร์ที่ไม่เกี่ยวข้องออก
• อัปเดตภาษาในบล็อกข้อความ
• แก้ไขภาพเคลื่อนไหว สี และแบบอักษรให้เข้ากับแบรนด์

หากต้องการปรับแต่งโฟลว์ โปรดอ่านหลักเกณฑ์ในคู่มือแนะนำสไตล์ของ Upgrade Party และระบุข้อมูลการปรับแต่งในการตอบกลับแบบฟอร์ม

คู่มือแนะนำสไตล์คำเชิญให้อัปเกรด

ใช้คู่มือแนะนำสไตล์นี้เพื่อแก้ไขลักษณะของคำเชิญให้อัปเกรดให้เหมาะกับแบรนด์ของคุณเอง (หน้าจอ สี แบบอักษร) เราขอแนะนำให้คงขนาดและโครงสร้างไว้ให้ใกล้เคียงกับการออกแบบเดิม

โฟลว์คำเชิญให้อัปเกรดมีคอมโพเนนต์ 3 รายการต่อไปนี้

• หน้าจออินโทร
• หน้าจอฟีเจอร์
• หน้าจอเอาต์โทร

ภาพเคลื่อนไหวในแต่ละหน้าจอจะช่วยอธิบายฟีเจอร์แต่ละรายการ

หน้าจออินโทร

หน้าจออินโทรมีภาพเคลื่อนไหวสั้นๆ ที่ต้อนรับผู้ใช้และกระตุ้นให้ผู้ใช้เริ่มโฟลว์ที่แสดงในหน้าจออินโทร

การจัดวาง

ภาพเคลื่อนไหวของอุปกรณ์ประกอบด้วยสิ่งต่อไปนี้เสมอ

• พื้นหลังสีขาวและรูปร่างหลากสีสัน
• เฟรมของอุปกรณ์
• เนื้อหา UI

การจัดรูปแบบ

หากเลือกปรับรูปแบบ Material You คุณสามารถใช้สีและรูปร่างเริ่มต้น ที่แสดงในตัวอย่างได้

หากใช้สีแบรนด์ของคุณเอง โปรดตรวจสอบว่าสีดังกล่าวเข้ากันได้ดีกับพื้นหลัง UI

การเคลื่อนไหว

ตัวเลือกที่ 1: มีนาฬิกาในหน้าจอหลัก

1. ตัวเลขปรากฏขึ้นบนหน้าจอ
2. ตัวเลขเคลื่อนไปตรงกลางพร้อมกับขนาดที่เล็กลง เฟรมโทรศัพท์มือถือปรากฏขึ้น
3. โทรศัพท์มีขนาดเล็กลง รูปร่างเริ่มปรากฏขึ้นบนหน้าจอ
4. ภาพเคลื่อนไหวเสร็จสมบูรณ์ รูปร่างเคลื่อนไหวช้าๆ ต่อไป

ตัวเลือกที่ 2: ไม่มีนาฬิกาในหน้าจอหลัก

1. โทรศัพท์มือถือปรากฏขึ้นบนหน้าจอ
2. โทรศัพท์เคลื่อนไปตรงกลางพร้อมกับขนาดที่ใหญ่ขึ้น รูปร่างเริ่มปรากฏขึ้นบนหน้าจอ
3. โทรศัพท์มีขนาดใหญ่ที่สุดและรูปร่างเคลื่อนไหวต่อไป

หน้าจอฟีเจอร์

หน้าจอฟีเจอร์แต่ละหน้าจอจะไฮไลต์ฟีเจอร์ในระบบปฏิบัติการใหม่

การจัดวาง

ภาพเคลื่อนไหวของอุปกรณ์ประกอบด้วยสิ่งต่อไปนี้เสมอ

• พื้นหลังหลากสีสัน
• เฟรมของอุปกรณ์
• เนื้อหา UI

การจัดรูปแบบ

• เลือกสีพื้นหลังที่เข้ากันได้ดีกับเนื้อหา UI และลักษณะโดยทั่วไป
• กำหนดขนาดแบบอักษรที่อ่านได้ง่ายภายในหน้าจอ หากจำเป็น ให้กำหนดขนาดแบบอักษรที่ใหญ่ขึ้น

การเคลื่อนไหว

บันทึกภาพเคลื่อนไหวของโฟลว์ฟีเจอร์แต่ละรายการ รวมถึงการโต้ตอบแบบสัมผัส ส่งออกการบันทึกเป็น ไฟล์ Lottie.

หน้าจอเอาต์โทร

หน้าจอเอาต์โทรจะทำให้โฟลว์สมบูรณ์ โดยจะระบุให้ผู้ใช้ทราบว่าได้ดูหน้าจอทั้งหมดแล้ว

การจัดวาง

ภาพเคลื่อนไหวของอุปกรณ์ประกอบด้วยสิ่งต่อไปนี้เสมอ

• ครึ่งวงกลมบนพื้นหลัง (พร้อมรูปร่างแบบเคลื่อนไหว)
• เฟรมของอุปกรณ์
• เนื้อหา UI

การจัดรูปแบบ

• เลือกสีพื้นหลังที่เข้ากันได้ดีกับเนื้อหา UI และลักษณะโดยทั่วไป
• ใช้รูปร่างครึ่งวงกลม

การเคลื่อนไหว

ทำตามโฟลว์ภาพเคลื่อนไหวมาตรฐานของหน้าจอเอาต์โทรดังนี้

1. โทรศัพท์มือถือเลื่อนขึ้นเล็กน้อย
2. วงกลมปรากฏขึ้นบนพื้นหลัง
3. รูปร่างปรากฏขึ้นจากด้านหลังโทรศัพท์มือถือ
4. รูปร่างบินออกจากพื้นหลังเหมือนกระดาษสี

ทริกเกอร์ Upgrade Party ด้วย SDK

โดยค่าเริ่มต้น ระบบปฏิบัติการ Android จะส่งการแจ้งเตือนแบบพุชให้ผู้ใช้เพื่อแสดงโฟลว์การ์ดพร้อมฟีเจอร์ล่าสุดทันทีที่ผู้ใช้อัปเกรด หากต้องการทริกเกอร์โฟลว์จากการแจ้งเตือนแบบพุชหรือแอปของคุณเอง ให้ใช้ Android SDK

สิ่งที่ต้องมีก่อน

ตรวจสอบว่าไฟล์บิลด์ของแอปใช้ค่าต่อไปนี้

• minSdkVersion ตั้งแต่ 14 ขึ้นไป
• compileSdkVersion ตั้งแต่ 28 ขึ้นไป

กำหนดค่าแอป

1. แตกไฟล์ไลบรารีจากไฟล์ ZIP ที่ให้มา แล้ววางไว้ในที่เก็บ

2. เพิ่มทรัพยากร Dependency สำหรับ Google Growth SDK ลงในไฟล์ Gradle ระดับแอปของโมดูล ซึ่งโดยปกติจะเป็น app/build.gradle ดังนี้

    dependencies {
        implementation files('<PATH_TO_BINARY>/play-services-growth-16.1.0-eap04.aar')
    }
   

3. รวมไลบรารีต่อไปนี้เป็นทรัพยากร Dependency

   com.google.android.gms:play-services-base:18.0.1
   com.google.android.gms:play-services-basement:18.0.0
   com.google.android.gms:play-services-tasks:18.0.1
   

ใช้ API

1. หากต้องการเริ่มต้นไคลเอ็นต์ ให้ใช้คลาส UpgradeParty และตั้งค่าพารามิเตอร์ activity

    import com.google.android.gms.growth.UpgradeParty;
    UpgradeParty.getClient(activity);
   

UpgradePartyClient ที่ได้จะแสดงฟังก์ชันการทำงานของ API

isEligibleForUpgradeParty

Task<Boolean> isEligibleForUpgradeParty();

แสดงออบเจ็กต์ Task ที่ตรวจสอบแบบไม่พร้อมกันว่าผู้ใช้มีสิทธิ์เข้าร่วม Upgrade Party หรือไม่ ค่าบูลีนที่ได้จะระบุว่าผู้ใช้มีสิทธิ์หรือไม่

invokeUpgradeParty

Task<Void> invokeUpgradeParty();

เรียกใช้ Activity ของ Upgrade Party ออบเจ็กต์ Task ที่ได้จะระบุว่าเกิดข้อผิดพลาดขึ้นเมื่อเริ่มต้นกิจกรรมหรือไม่

ข้อผิดพลาด

เมธอด API ทั้ง 2 รายการอาจล้มเหลวโดยมีข้อยกเว้นประเภท com.google.android.gms.common.api.ApiException ในกรณีเช่นนี้ ผู้เรียกจะต้องลองอีกครั้งในภายหลัง

รหัสสถานะทั่วไปที่คาดไว้มีดังนี้

• INTERNAL_ERROR: แสดงถึงข้อผิดพลาดใดๆ ในโฟลว์ของตรรกะพื้นฐาน
• TIMEOUT: แสดงขึ้นเมื่อไม่สามารถจัดการคำขอได้ทันเวลา
• API_NOT_CONNECTED: หมายความว่า API ไม่พร้อมใช้งาน (เช่น โมดูล UpgradeParty ยังไม่พร้อม)
• DEVELOPER_ERROR: แสดงขึ้นเมื่อแพ็กเกจที่เรียกใช้ไม่ได้รับอนุญาตให้เข้าถึงคลาส UpgradeParty

ตัวอย่าง SDK

ดูตัวอย่างแอปที่เรียกใช้ SDK ได้ที่ด้านล่าง

import android.app.Activity;
import android.os.Bundle;
import android.view.View;
import com.google.android.gms.growth.UpgradeParty;
import com.google.android.gms.growth.UpgradePartyClient;

public class SampleActivity extends Activity {

 @Override
 protected void onCreate(Bundle savedInstanceState) {
   super.onCreate(savedInstanceState);
   final UpgradePartyClient client = UpgradeParty.getClient(this);

   // Hide the invocation button initially
   View startUpgradePartyButton = findViewById(R.id.__some_button__);
   startUpgradePartyButton.setVisibility(View.GONE);

   // Register an onClick handler to invoke the Upgrade Party Activity
   startUpgradePartyButton
       .setOnClickListener(
           view -> {
             client
                 .invokeUpgradeParty()
                 .addOnCompleteListener(
                     task -> {
                       if (!task.isSuccessful()) {
                         // Do something with error, see task.getException()
                       }
                     });
           });
   }

   // Check if eligible for an Upgrade Party
   client
       .isEligibleForUpgradeParty()
       .addOnCompleteListener(
           task -> {
             if (!task.isSuccessful()) {
               // Do something with error, see task.getException()
             } else {
                  // Show/Hide invocation button, based on the result
                  int visibility =
                        task.getResult() ? View.VISIBLE : View.GONE;
                  startUpgradePartyButton..setVisibility(visibility);
             }
           });
   }

ทดสอบโฟลว์ Upgrade Party

ทำตามขั้นตอนต่อไปนี้เพื่อทดสอบโฟลว์ Upgrade Party ที่ผู้ใช้จะเห็นเมื่ออัปเกรดระบบปฏิบัติการ Android

1. ในอุปกรณ์ Android ที่ใช้ทดสอบ ให้ไปที่การตั้งค่า > Google > การแก้ไขข้อบกพร่องของ Upgrade Party
2. เลือกรายงานการอัปเกรด แล้วเลือกเปิด Upgrade Party การดำเนินการนี้จะเริ่มโฟลว์ที่เกี่ยวข้องตามเวอร์ชันระบบปฏิบัติการของอุปกรณ์ เช่น Upgrade Party ของ Android 12 จะเล่นในอุปกรณ์ที่ใช้ระบบปฏิบัติการ Android 12