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

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

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

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

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

ปรับแต่งประสบการณ์ปาร์ตี้อัพเกรด

คุณสามารถปรับแต่งประสบการณ์การอัพเกรดปาร์ตี้ได้ด้วยวิธีต่อไปนี้:

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

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

ทริกเกอร์ฝ่ายอัปเกรดด้วย SDK

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

ข้อกำหนดเบื้องต้น

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

• minSdkVersion 14 หรือสูงกว่า
• compileSdkVersion 28 หรือสูงกว่า

กำหนดค่าแอปของคุณ

1. แยกไลบรารีออกจากไฟล์ Zip ที่ให้มา และวางลงในที่เก็บของคุณ

2. เพิ่มการพึ่งพาสำหรับ Google Growth SDK ลงในไฟล์ Gradle ระดับแอปของโมดูลของคุณ โดยปกติแล้ว app/build.gradle :

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

3. รวมไลบรารีต่อไปนี้เป็นสิ่งอ้างอิง:

   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
   

ใช้เอพีไอ

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

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

UpgradePartyClient ที่เป็นผลลัพธ์จะเปิดเผยฟังก์ชันการทำงานของ API

มีสิทธิ์สำหรับการอัพเกรดปาร์ตี้

Task<Boolean> isEligibleForUpgradeParty();

ส่งคืนวัตถุ Task ที่ตรวจสอบแบบอะซิงโครนัสว่าผู้ใช้มีสิทธิ์สำหรับฝ่ายอัปเกรดหรือไม่ ค่าบูลีนที่ได้จะบ่งชี้ว่าผู้ใช้มีสิทธิ์หรือไม่

เรียกใช้UpgradeParty

Task<Void> invokeUpgradeParty();

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

ข้อผิดพลาด

API ทั้งสองวิธีอาจล้มเหลวได้ยกเว้นประเภท 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. เลือก รายงานการอัปเกรด แล้วเลือก Open Upgrade Party ซึ่งจะเริ่มขั้นตอนที่เกี่ยวข้องโดยอิงตามเวอร์ชันระบบปฏิบัติการของอุปกรณ์ เช่น ปาร์ตี้อัปเกรด Android 12 จะเล่นบนอุปกรณ์ที่ใช้ระบบปฏิบัติการ Android 12