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

จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ

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

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

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

ผู้ผลิตอุปกรณ์สามารถเปิดใช้ Upgrade Party สำหรับอุปกรณ์ระบบปฏิบัติการ Android ได้โดยส่งแบบฟอร์มคําขอเปิดใช้งาน Android 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 จะส่งข้อความ Push แสดงฟีดการ์ดพร้อมฟีเจอร์ล่าสุดให้ผู้ใช้ทราบทันทีที่อัปเกรด หากต้องการทริกเกอร์ขั้นตอนจาก Push Notification ของคุณเองหรือแอป ให้ใช้ 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 ที่ตรวจสอบแบบไม่พร้อมกันว่าผู้ใช้มีสิทธิ์เข้าร่วมโปรแกรมการอัปเกรดหรือไม่ ค่าบูลีนที่ได้จะระบุว่าผู้ใช้มีสิทธิ์หรือไม่

invokeUpgradeParty

Task<Void> invokeUpgradeParty();

เรียกใช้ Upgrade Party Activity ออบเจ็กต์ 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);
             }
           });
   }

ทดสอบขั้นตอนอัปเกรดบุคคล

ทําตามขั้นตอนต่อไปนี้เพื่อทดสอบขั้นตอนอัปเกรดปาร์ตี้ที่ผู้ใช้เห็นเมื่ออัปเกรดระบบปฏิบัติการ Android

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