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

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

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

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

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

ปรับแต่งประสบการณ์การเข้าร่วมโปรแกรมอัปเกรด

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

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

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

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

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

ขั้นตอนการเชิญให้อัปเกรดประกอบด้วย 3 องค์ประกอบต่อไปนี้

  • หน้าจอแนะนำ
  • หน้าจอฟีเจอร์
  • หน้าจอปิดท้าย
รูปที่ 1 หน้าจอทั้ง 3 ประเภทในขั้นตอนคำเชิญอัปเกรด

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

หน้าจอแนะนำ

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

เลย์เอาต์
รูปที่ 2 เลย์เอาต์ภาพร่างสำหรับหน้าจอแนะนำคำเชิญให้อัปเกรด

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

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

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

รูปที่ 3 รูปแบบสีเริ่มต้นสำหรับขั้นตอนการเชิญให้อัปเกรด

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

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

ตัวเลือกที่ 1: แสดงนาฬิกาบนหน้าจอหลัก

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

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

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

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

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

เลย์เอาต์
รูปที่ 8 เลย์เอาต์ภาพร่างสำหรับหน้าจอฟีเจอร์คำเชิญให้อัปเกรด

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

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

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

หน้าจอปิดท้าย

หน้าจอด้านนอกจะดำเนินไปอย่างราบรื่น ข้อความนี้บ่งบอกให้ผู้ใช้ทราบว่าได้ดูทุกหน้าจอแล้ว

เลย์เอาต์
รูปที่ 9 เลย์เอาต์แบบไวร์เฟรมสำหรับหน้าจอปิดท้ายคำเชิญอัปเกรด

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

  • ครึ่งวงกลมบนพื้นหลัง (พร้อมรูปร่างแบบเคลื่อนไหว)
  • เฟรมของอุปกรณ์
  • เนื้อหา UI
การจัดแต่ง
  • เลือกสีพื้นหลังที่เข้ากับเนื้อหา UI และลักษณะทั่วไป
  • ใช้รูปร่างครึ่งวงกลม
การเคลื่อนไหว

ทำตามขั้นตอนภาพเคลื่อนไหวมาตรฐานของหน้าจอปิดท้าย

  1. โทรศัพท์มือถือขยับขึ้นเล็กน้อย
  2. วงกลมจะปรากฏขึ้นในพื้นหลัง
  3. รูปทรงปรากฏขึ้นจากด้านหลังโทรศัพท์มือถือ
  4. รูปร่างจะโผล่ออกมาจากพื้นหลังเหมือนลูกปา
รูปที่ 10 เลย์เอาต์ภาพร่างสำหรับภาพเคลื่อนไหวในหน้าจอปิดท้ายของคำเชิญให้อัปเกรด
รูปที่ 11 ตัวอย่างภาพเคลื่อนไหวนอกหน้าจอ

ทริกเกอร์ 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