建立票證並編碼至 JWT 後,即可直接在 Android 應用程式中發出。操作步驟如下:檢查使用者裝置是否支援 Google Wallet API,並註明「新增至 Google 錢包」按鈕,然後輕觸按鈕,即可將票證儲存到 Google 錢包。
必要條件
核發票證前,請確認已完成下列事項:
,瞭解如何調查及移除這項存取權。1. 安裝 Google 錢包 Android SDK
如要使用 Google 錢包 Android SDK,請在應用程式層級 build.gradle
檔案的 dependencies
部分新增 com.google.android.gms:play-services-pay
:
implementation "com.google.android.gms:play-services-pay:16.5.0"
2. 確認 Google Wallet API 適用國家/地區
儲存新物件之前,請確認 Google Wallet API 為
透過呼叫 PayClient
類別的 getPayApiAvailabilityStatus
方法,在目標裝置上提供可用版本。
首先,將成員變數新增至 活動中,會顯示按鈕,並在活動發生時將按鈕執行個體化 已建立:
Kotlin
import com.google.android.gms.pay.PayClient
private lateinit var walletClient: PayClient
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
walletClient = Pay.getClient(this)
// Additional logic in your onCreate method
}
Java
import com.google.android.gms.pay.PayClient;
private final PayClient walletClient;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
walletClient = Pay.getClient(application);
// Additional logic in your onCreate method
}
如果您使用其他設計模式,請考慮以適當的方式放置特定領域的商業邏輯。比方說,如果您使用 MVVM 模式 在「活動」或「片段」中加入 UI 相關商業邏輯 (例如使用者介面元素 活動結果) 和檢視模型中的操作邏輯 (例如:client 建立例項。
接著,使用 PayClient
檢查 API 是否可用:
Kotlin
import com.google.android.gms.pay.PayApiAvailabilityStatus
private fun fetchCanUseGoogleWalletApi() {
walletClient
.getPayApiAvailabilityStatus(PayClient.RequestType.SAVE_PASSES)
.addOnSuccessListener { status ->
if (status == PayApiAvailabilityStatus.AVAILABLE) {
// The API is available, show the button in your UI
} else {
// The user or device is not eligible for using the Pay API
}
}
.addOnFailureListener {
// Hide the button and optionally show an error message
}
}
Java
import com.google.android.gms.pay.PayApiAvailabilityStatus;
private void fetchCanAddPassesToGoogleWallet() {
walletClient
.getPayApiAvailabilityStatus(PayClient.RequestType.SAVE_PASSES)
.addOnSuccessListener(status -> {
if (status == PayApiAvailabilityStatus.AVAILABLE) {
// The API is available, show the button in your UI
} else {
// The user or device is not eligible for using the Pay API
};
})
.addOnFailureListener(exception -> {
// Google Play Services is too old, or API availability not verified
// Hide the button and optionally show an error message
});
}
最後,如果需要判斷 API 的可用性,請呼叫您剛才在應用程式中定義的方法。
API 無法使用時的處理方式
API 無法使用的可能原因包括 Android 或 Google Play 服務版本過舊,或 Google 錢包已停用 無法在使用者的國家/地區使用
如果 API 無法使用 請考慮隱藏按鈕,並改用不同的整合方式 (例如 使用 JWT 連結)。請注意,使用者日後可能符合使用該 API 的資格。
3. 新增「新增至 Google 錢包」按鈕
「Google 錢包」提供熟悉的按鈕,可用來觸發 將這項功能新增至應用程式的 Google 錢包流程。按鈕的向量素材資源為 提供的 按鈕規範:
您可以在 Android Studio 的 File > New > Vector Asset
底下匯入向量素材資源。選取「本機檔案」在精靈中新增名稱 (例如:
add_to_google_wallet_button.xml
),然後在本機磁碟中找到該檔案,以匯入該檔案。
現在,您可以使用匯入的可繪項目,將按鈕新增至使用者介面:
<ImageButton android:id="@+id/addToGoogleWalletButton" android:layout_width="match_parent" android:layout_height="48dp" android:minWidth="200dp" android:clickable="true" android:src="@drawable/add_to_google_wallet_button" />
按鈕的 layout_height
為 48 dp,寬度不得小於 200 dp。
4. 將票證新增至使用者的 Google 錢包
將未簽署的 JWT 傳送至 savePasses
方法,即可新增 FlightObject
。
你必須先點選「Google 錢包」,即可開始新增作業
按鈕。
Kotlin
import android.os.Bundle
import android.view.View
import com.google.android.gms.samples.wallet.databinding.ActivityCheckoutBinding
private val addToGoogleWalletRequestCode = 1000
private lateinit var layout: ActivityCheckoutBinding
private lateinit var addToGoogleWalletButton: View
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
// Use view binding to access the UI elements
layout = ActivityCheckoutBinding.inflate(layoutInflater)
setContentView(layout.root)
addToGoogleWalletButton = layout.addToGoogleWalletButton
addToGoogleWalletButton.setOnClickListener {
walletClient.savePasses(newObjectJson, this, addToGoogleWalletRequestCode)
}
// Additional logic in your onCreate method
}
Java
import android.os.Bundle;
import android.view.View;
import com.google.android.gms.samples.wallet.databinding.ActivityCheckoutBinding;
private static final int ADD_TO_GOOGLE_WALLET_REQUEST_CODE = 999;
private ActivityCheckoutBinding layout:
private View addToGoogleWalletButton;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
// Use view binding to access the UI elements
layout = ActivityCheckoutBinding.inflate(getLayoutInflater());
setContentView(layout.getRoot());
addToGoogleWalletButton = layout.addToGoogleWalletButton;
addToGoogleWalletButton.setOnClickListener(v -> {
walletClient.savePasses(newObjectJson, this, ADD_TO_GOOGLE_WALLET_REQUEST_CODE);
});
// Additional logic in your onCreate method
}
結果處理
savePasses
方法會觸發儲存流程並叫用
儲存流程完成後的 onActivityResult
方法。onActivityResult
的實作應如下所示:
Kotlin
import android.content.Intent
override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
super.onActivityResult(requestCode, resultCode, data)
if (requestCode == addToGoogleWalletRequestCode) {
when (resultCode) {
RESULT_OK -> {
// Pass saved successfully
}
RESULT_CANCELED -> {
// Save operation canceled
}
PayClient.SavePassesResult.SAVE_ERROR -> data?.let { intentData ->
val errorMessage = intentData.getStringExtra(PayClient.EXTRA_API_ERROR_MESSAGE)
// Handle error
}
else -> {
// Handle unexpected (non-API) exception
}
}
}
}
Java
import android.content.Intent;
@Override
protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {
super.onActivityResult(requestCode, resultCode, data);
if (requestCode == ADD_TO_GOOGLE_WALLET_REQUEST_CODE) {
switch (resultCode) {
case RESULT_OK: {
// Pass saved successfully
break;
}
case RESULT_CANCELED: {
// Save operation canceled
break;
}
case PayClient.SavePassesResult.SAVE_ERROR: {
if (data != null) {
String apiErrorMessage = data.getStringExtra(PayClient.EXTRA_API_ERROR_MESSAGE);
// Handle error
}
break;
}
default: {
// Handle unexpected (non-API) exception
}
}
}
}
成功新增票證後,resultCode
會包含 Activity.RESULT_OK
的值。