Android SDK による問題パス

パスを作成して JWT でエンコードしたら、Android アプリで発行する準備が整います。これを行うには、ユーザーのデバイスで Google Wallet API が使用可能かどうかを確認し、[Google ウォレットに追加] ボタンを表示して、ユーザーがボタンをタップしたらパスを Google ウォレットに保存する必要があります。

前提条件

パスを発行する前に、次のことを完了していることを確認してください。

オンボーディングガイドのすべての手順を完了している。
少なくとも 1 つのパスクラスを作成している。
少なくとも 1 つのパスオブジェクトを作成している。
パスクラスとパスオブジェクトを JWT でエンコードしている。

1. Google Wallet Android SDK をインストールする

Google Wallet 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 が使用可能であることを、getPayApiAvailabilityStatus クラスの PayClient メソッドを呼び出して確認します。

まず、ボタンを表示するアクティビティにメンバー変数を追加し、そのアクティビティが作成されたときに変数をインスタンス化します。

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 要素、アクティビティの結果など）を Activity または Fragment に配置し、UI 要素、アクティビティの結果）、および操作ロジック（クライアントのインスタンス化、ネットワーク呼び出しのトリガーなど）をビューモデルに配置します。

次に、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 を使用してインポートできます。ウィザードで [Local file] を選択して名前（例: 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 ウォレットにパスを追加する

TransitObject を追加するには、無署名の JWT を savePasses メソッドに渡します。 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 の値が格納されます。

Android SDK による問題パス コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

前提条件

1. Google Wallet Android SDK をインストールする

2. Google Wallet API が使用可能かどうかを確認する

Kotlin

Java

Kotlin

Java

API が使用できない場合の処理

3. [Google ウォレットに追加] ボタンを追加する

4. ユーザーの Google ウォレットにパスを追加する

Kotlin

Java

結果の処理

Kotlin

Java

Android SDK による問題パス