升級派對是一種探索流程,可在 Android 使用者收到主要作業系統升級時,為他們醒目顯示新功能。
重大的 Android 作業系統升級作業可能會讓使用者感到失望。升級派對流程可提高使用者參與度,並協助使用者瞭解如何瀏覽新版 OS。
升級至最新 OS 版本後,使用者會收到推播通知,歡迎他們使用新 OS,並展示含有新功能的資訊卡流程。
如要為 Android 作業系統啟用升級功能,請使用要求啟用 Android 升級功能表單進行註冊。
自訂升級方體驗
您可以透過下列方式自訂升級方體驗:
- 請移除不相關的功能。
- 更新文字區塊的語言。
- 修改動畫、顏色和字型,配合您的品牌。
如要自訂流程,請參閱升級派對風格指南中的規範,並在要求啟用 Android 升級派對表單中加入自訂資訊。
升級邀請樣式指南
請參考本樣式指南,修改升級邀請的外觀,以符合您的品牌 (螢幕、顏色、字型)。強烈建議您將大小和結構保持與原始設計相近。
升級邀請流程包含以下三個部分:
- 簡介畫面
- 功能畫面
- Outro 畫面
每個畫面都有動畫說明各項功能。
簡介畫面
簡介畫面包含簡短的動畫,歡迎使用者並鼓勵他們開始在簡介畫面中顯示的流程。
版面配置
裝置動畫一律包含:
- 白色背景和彩色圖形
- 裝置外框
- UI 內容
樣式
如果您選擇採用 Material You 樣式,可以使用範例中顯示的預設顏色和形狀。
如果您使用自有品牌顏色,請確認該顏色與 UI 背景搭配良好。
動作
選項 1:在主畫面上顯示時鐘
- 畫面上會顯示數字。
- 數字會移至中央並縮小。手機框架會隨即顯示。
- 手機尺寸縮小。形狀開始進入畫面。
- 動畫已完成。形狀會持續緩慢移動。
選項 2:主畫面上沒有時鐘
- 手機進入畫面。
- 手機放大時,手機會往畫面中央。形狀開始進入畫面。
- 手機達到最大尺寸,形狀持續移動。
功能畫面
每個功能畫面都會強調新作業系統中的某項功能。
版面配置
裝置動畫一律包含:
- 色彩繽紛的背景
- 裝置邊框
- UI 內容
樣式
- 選擇適合 UI 內容及一般外觀的背景顏色。
- 在螢幕中設定易於辨識的字型大小。您可以視需要設定較大的字型大小。
動作
記錄每個功能的流程動畫,包括觸控互動。將錄製內容匯出為 Lottie 檔案。
Outro 畫面
結尾畫面會完成流程。這會向使用者指出他們已瀏覽過所有畫面。
版面配置
裝置動畫一律包含:
- 背景上的半圓形 (加上動畫形狀)
- 裝置邊框
- UI 內容
樣式
- 請選取與 UI 內容和一般外觀搭配良好的背景顏色。
- 使用半圓形。
動作
請按照標準結尾畫面動畫流程操作:
- 手機會稍微往上移動。
- 背景會顯示圓圈。
- 手機後方出現形狀。
- 形狀從背景中冒出,如五彩碎紙。
使用 SDK 觸發升級程序
根據預設,Android OS 會在使用者升級後,傳送推播通知,展示含有最新功能的資訊卡流程。如果您想透過自訂推播通知或應用程式觸發流程,請使用 Android SDK。
必要條件
請確認應用程式的版本檔案使用下列的值:
minSdkVersion
14 以上版本compileSdkVersion
28 以上
設定應用程式
- 從提供的 ZIP 檔案中解壓縮程式庫,並將其放入存放區。
將 Google Growth SDK 的依附元件新增至模組的應用程式層級 Gradle 檔案,通常為
app/build.gradle
:dependencies { implementation files('<PATH_TO_BINARY>/play-services-growth-16.1.0-eap04.aar') }
將下列程式庫納入依附元件:
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
如要初始化用戶端,請使用
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 方法都可能會失敗,並擲回 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 作業系統時看到的升級程序流程:
- 在測試 Android 裝置上,依序前往「設定」>「Google」>「Upgrade Party debug」。
- 依序選取「回報升級」和「開啟升級派對」。系統會根據裝置 OS 版本啟動相關流程。舉例來說,Android 12 升級派對會在搭載 Android 12 作業系統的裝置上播放。