이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Android SDK 관련 문제 전달

패스를 만들어 JWT로 인코딩하면 Android 앱에서 발급할 수 있습니다. 이렇게 하려면 사용자의 기기에서 Google Wallet API를 사용할 수 있는지 확인하고 'Google 월렛에 추가' 메시지를 표시해야 합니다. 버튼을 탭한 다음 버튼을 탭하면 Google 월렛에 패스가 저장됩니다.

기본 요건

패스를 발급하기 전에 다음을 완료했는지 확인하세요.

온보딩 가이드의 모든 단계를 완료했습니다.
패스 클래스를 하나 이상 만듭니다.
패스 객체를 하나 이상 만듭니다.
JWT에서 패스 클래스와 패스 객체를 인코딩했습니다.

를 통해 개인정보처리방침을 정의할 수 있습니다.

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 메서드에 전달하여 TransitObject를 추가할 수 있습니다. Google 월렛 아이콘을 클릭하면 추가 작업을 시작할 수 있습니다. 버튼을 클릭합니다.

참고: Android와 웹 모두에 통합하는 경우 서명된 웹 통합에 필요한 JWT로, savePasses 대신 savePassesJwt를 호출합니다.

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 값이 포함됩니다.