패스를 만들어 JWT로 인코딩하면 Android 앱에서 발급할 수 있습니다. 이렇게 하려면 사용자의 기기에서 Google Wallet API를 사용할 수 있는지 확인하고 'Google 월렛에 추가' 메시지를 표시해야 합니다. 버튼을 탭한 다음 버튼을 탭하면 Google 월렛에 패스가 저장됩니다.
기본 요건
패스를 발급하기 전에 다음을 완료했는지 확인하세요.
를 통해 개인정보처리방침을 정의할 수 있습니다.1. Google 월렛 Android SDK 설치
Google 월렛 Android SDK를 사용하려면 com.google.android.gms:play-services-pay
을 앱 수준 build.gradle
파일의 dependencies
섹션에 추가하세요.
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
}
자바
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 요소 뷰 모델의 작업 로직 (예: 클라이언트) 인스턴스화, 네트워크 호출 트리거).
그런 다음 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
}
}
자바
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 스튜디오의 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
는 48dp이며 너비는 최소 200dp여야 합니다.
4. 사용자의 Google 월렛에 패스 추가
서명되지 않은 JWT를 savePasses
메서드에 전달하여 GiftCardObject
를 추가할 수 있습니다.
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
}
자바
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
}
}
}
}
자바
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
값이 포함됩니다.