本頁面由 Cloud Translation API 翻譯而成。

Android SDK 相關問題

建立票證並編碼至 JWT 後，即可直接在 Android 應用程式中發出。操作步驟如下：檢查使用者裝置是否支援 Google Wallet API，並註明「新增至 Google 錢包」按鈕，然後輕觸按鈕，即可將票證儲存到 Google 錢包。

必要條件

核發票證前，請確認已完成下列事項：

您已完成入門指南中的所有步驟。
至少建立一個票證類別。
建立至少一個票證物件。
在 JWT 中對票證類別和票證物件經過編碼。

，瞭解如何調查及移除這項存取權。

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 相關商業邏輯 (例如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 方法，即可新增 GiftCardObject。你必須先點選「Google 錢包」，即可開始新增作業按鈕。

注意：如果您要同時整合 Android 和網頁版，可以將已簽署的網站整合所需的 JWT，呼叫 savePassesJwt 而非 savePasses。

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 的值。