Nachdem du eine Karte bzw. ein Ticket erstellt und in einem JWT codiert hast, kannst du sie in deiner Android-App ausstellen. Dazu musst du prüfen, ob die Google Wallet API auf dem Gerät des Nutzers verfügbar ist, die Schaltfläche „Zu Google Wallet hinzufügen“ einblenden und die Karte bzw. das Ticket in Google Wallet speichern, sobald sie auf die Schaltfläche tippen.
Voraussetzungen
Bevor Sie eine Karte bzw. ein Ticket ausstellen, müssen Sie Folgendes tun:
- Sie haben alle im Leitfaden zur Teilnahme aufgeführten Schritte abgeschlossen.
- Erstellen Sie mindestens eine Karten-/Ticketklasse.
- Erstelle mindestens ein Karten-/Ticketobjekt.
- Codierung der Karten-/Ticketklasse und des Karten-/Ticketobjekts in einem JWT:
1. Google Wallet Android SDK installieren
Wenn du das Google Wallet Android SDK verwenden möchtest, füge com.google.android.gms:play-services-pay
zum Abschnitt dependencies
der Datei build.gradle
auf App-Ebene hinzu:
implementation "com.google.android.gms:play-services-pay:16.5.0"
2. Verfügbarkeit der Google Wallet API prüfen
Prüfe vor dem Speichern des neuen Objekts, ob die Google Wallet API auf dem Zielgerät verfügbar ist. Rufe dazu die Methode getPayApiAvailabilityStatus
in der Klasse PayClient
auf.
Fügen Sie der Aktivität zuerst eine Member-Variable hinzu, in der Sie die Schaltfläche einblenden möchten, und instanziieren Sie sie, wenn die Aktivität erstellt wird:
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
}
Wenn Sie andere Designmuster verwenden, sollten Sie die domainspezifische Geschäftslogik entsprechend platzieren. Wenn du beispielsweise das MVVM-Muster verwendest, platziere die UI-bezogene Geschäftslogik in deiner Aktivität oder deinem Fragment (z. B. UI-Elemente, Aktivitätsergebnisse) und die operative Logik im Ansichtsmodell (z. B. Client-Instanziierung, Trigger für Netzwerkaufrufe).
Prüfen Sie als Nächstes mit PayClient
, ob die API verfügbar ist:
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
});
}
Rufen Sie schließlich die eben in Ihrer Anwendung definierte Methode auf, wenn Sie die Verfügbarkeit der API ermitteln möchten.
Verarbeiten, wenn die API nicht verfügbar ist
Mögliche Gründe, warum die API nicht verfügbar ist, können sein, dass die Versionen der Android- oder Google Play-Dienste veraltet sind oder dass Google Wallet im Land des Nutzers nicht verfügbar ist.
Wenn die API nicht verfügbar ist, kannst du die Schaltfläche ausblenden und auf eine andere Integration zurückgreifen (z.B. mithilfe eines JWT-Links). Hinweis: Der Nutzer kann die API möglicherweise in Zukunft verwenden.
3. Schaltfläche „Zu Google Wallet hinzufügen“ hinzufügen
Google Wallet bietet eine vertraute Schaltfläche, mit der du den Vorgang „Zu Google Wallet hinzufügen“ in deiner Anwendung auslösen kannst. Vektor-Assets für die Schaltfläche sind in den Richtlinien für Schaltflächen verfügbar.
Du kannst Vektor-Assets in Android Studio unter File > New > Vector Asset
importieren. Wählen Sie im Assistenten "Lokale Datei" aus, fügen Sie einen Namen hinzu (z. B.
add_to_google_wallet_button.xml
) und suchen Sie die Datei auf Ihrem lokalen Laufwerk, um sie zu importieren.
Jetzt kannst du das importierte Drawable verwenden, um die Schaltfläche deiner Benutzeroberfläche hinzuzufügen:
<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" />
Die Schaltfläche hat eine layout_height
von 48 dp und muss mindestens 200 dp breit sein.
4. Karte/Ticket zu Google Wallet eines Nutzers hinzufügen
EventObject
kann hinzugefügt werden, indem ein unsigniertes JWT an die Methode savePasses
übergeben wird.
Du kannst den Vorgang starten, nachdem du auf die Schaltfläche „Google Wallet“ geklickt hast.
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
}
Ergebnisverarbeitung
Die Methode savePasses
löst den Speichervorgang aus und ruft die Methode onActivityResult
auf, nachdem der Vorgang abgeschlossen ist. Die Implementierung von onActivityResult
sollte in etwa so aussehen:
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
}
}
}
}
Wenn die Karte bzw. das Ticket erfolgreich hinzugefügt wurde, enthält resultCode
den Wert Activity.RESULT_OK
.