クイックアクセスウォレット

Android 11 で導入されたクイックアクセスウォレット機能を使用すると、ユーザーは電源ボタンメニューから支払いカードと関連パスに直接アクセスできます。主なユースケースとしては、NFC デバイスで取引を実行する前に該当の支払い方法を選択する場合や、今後のイベントのフライトなどのパスにすばやくアクセスする場合があります。

Android 12 以降では、図 1 と図 2 に示すように、クイックアクセスウォレット機能をシェードから利用できます。

クイックアクセスウォレット機能（シェード内） — **図 1.** クイックアクセスウォレット機能（デバイスはロック状態）

Android 11 では、図 3 に示すように、この機能を電源ボタンメニューから利用できます。

要件

クイックアクセスウォレット機能を使用するには、デバイスに NFC が搭載されていることが必要です。この機能は、デフォルトの NFC 支払いアプリの QuickAccessWalletService にバインドします。つまり、デバイスは NFC ホストベースのカードエミュレーション（HCE）もサポートする必要があります。

機能の概要

クイックアクセスウォレットには 2 つの部分があります。それは、クイックアクセスウォレット UI とクイックアクセスウォレットカードプロバイダです。

Android 12 以降では、ウォレット UI はシステム UI 内で動作し、frameworks/base/packages/SystemUI/src/com/android/systemui/wallet にあります。Android 11 では、platform/packages/apps/QuickAccessWallet にあるウォレット UI をインストールして許可リストに登録する必要があります。

クイックアクセスウォレットカードプロバイダは、デフォルトの NFC 支払いアプリです。ユーザーは複数の NFC 支払いアプリを同時にインストールできますが、電源ボタンメニューにカードを表示できるのはデフォルトの NFC 支払いアプリだけです。デフォルトに設定する NFC 支払いアプリは出荷前に指定できますが、ユーザーは設定ページで別のアプリを選択できます。インストールされた NFC 支払いアプリが 1 つのみである場合は、そのアプリが自動的にデフォルトになります（CardEmulationManager を参照）。

実装

クイックアクセスウォレット UI にカードを提供するには、NFC 支払いアプリに QuickAccessWalletService を実装する必要があります。支払いアプリには、サービスをアドバタイズするマニフェストエントリを含める必要があります。

システム UI のみが QuickAccessWalletService にバインドできるようにするには、NFC 支払いアプリが android.permission.BIND_QUICK_ACCESS_WALLET_SERVICE 権限を要求する必要があります。この権限を要求することにより、システム UI のみが QuickAccessWalletService にバインドできるようになります。

<service
     android:name=".MyQuickAccessWalletService"
     android:label="@string/my_default_tile_label"
     android:icon="@drawable/my_default_icon_label"
     android:logo="@drawable/my_wallet_logo"
     android:permission="android.permission.BIND_QUICK_ACCESS_WALLET_SERVICE">
     <intent-filter>
         <action android:name="android.service.quickaccesswallet.QuickAccessWalletService" />
         <category android:name="android.intent.category.DEFAULT"/>
     </intent-filter>
     <meta-data android:name="android.quickaccesswallet"
          android:resource="@xml/quickaccesswallet_configuration" />
     <meta-data
          android:name="android.quickaccesswallet.tile"
          android:resource="@drawable/my_default_tile_icon"/>
</service>

ウォレットに関する追加情報は、リンク先の XML ファイルに含まれています。

<quickaccesswallet-service
   xmlns:android="http://schemas.android.com/apk/res/android"
   android:settingsActivity="com.example.android.SettingsActivity"
   android:shortcutLongLabel="@string/my_wallet_empty_state_text"
   android:shortcutShortLabel="@string/my_wallet_button_text"
   android:targetActivity="com.example.android.WalletActivity"/>

次に、支払いアプリに QuickAccessWalletService を実装する必要があります。

public class MyQuickAccessWalletService extends QuickAccessWalletService {

    @Override
    public void onWalletCardsRequested(
            GetWalletCardsRequest request,
            GetWalletCardsCallback callback) {
        GetWalletCardsResponse response = // generate response
        callback.onSuccess(response);
    }

    @Override
    public void onWalletCardSelected(SelectWalletCardRequest request) {
        // selecting a card should ensure that it is used when making an NFC payment
    }

    @Override
    public void onWalletDismissed() {
        // May un-select card if the wallet app has the concept of a 'default'
        // payment method
    }
}

HostApduService が NFC トランザクションの処理を開始し、その結果として支払いの進捗状況と結果を表示するアクティビティが開始されたら、バインドされた QuickAccessWalletService への参照を取得し、イベントタイプ TYPE_NFC_PAYMENT_STARTED を使用して QuickAccessWalletService#sendEvent を呼び出す必要もあります。それによってクイックアクセスウォレット UI が閉じられ、ユーザーは UI に遮られずに支払いアクティビティを見ることができます。

QuickAccessWalletService の実装方法に関するその他のドキュメントとしては、QuickAccessWalletService および TestQuickAccessWalletService CTS テストをご覧ください。

Android 11 でクイックアクセスウォレット UI を有効にする

Android 11 の電源ボタンメニューからクイックアクセスウォレットを利用できるように構成するには、ビルドに QuickAccessWallet ターゲットを組み込み、下記のコードサンプルにおいて太字で示されている行を overlay/frameworks/base/packages/SystemUI/res/values/config.xml ファイルに追加して globalactions.wallet プラグインを有効にします。

<resources>
    ...
    <!-- SystemUI Plugins that can be loaded on user builds. -->
    <string-array name="config_pluginWhitelist" translatable="false">
        <item>com.android.systemui</item>
        <item>com.android.systemui.plugin.globalactions.wallet</item>
    </string-array>
</resources>

def_nfc_payment_component を使用して、設定の構成ファイルにデフォルトの NFC 支払いアプリを指定します。

クイックアクセスウォレットにカードを提供するには、デフォルトの NFC 支払いアプリが QuickAccessWalletService を公開する必要があります。デフォルトの NFC 支払いアプリがこのサービスをエクスポートしないと、ウォレット UI は表示されません。

QuickAccessWalletService 実装の詳細

QuickAccessWalletService に、onWalletCardsRequested、onWalletCardSelected、onWalletDismissed の 3 つの抽象メソッドを実装する必要があります。下記のシーケンス図は、クイックアクセスウォレットが NFC 支払いの直前に表示されるときの呼び出しシーケンスを示しています。

クイックアクセスウォレットのシーケンス図

**図 4.** クイックアクセスウォレットが表示されるときの呼び出しシーケンスの例

クイックアクセスウォレットの表示後に常に NFC 支払いが行われるわけではありませんが、上記の図 4 は QuickAccessWalletService のすべての機能を示しています。この例では、クイックアクセスウォレットカードプロバイダは青い枠で囲まれた要素を実装しています。支払いカードはデバイス内のデータベースに保存され、PaymentCardManager という名前のインターフェースを介してアクセスされると想定しています。さらに、PaymentActivity という名前のアクティビティによって NFC 支払いの結果が表示されると想定しています。フローは次のように進行します。

ユーザーがクイックアクセスウォレットを表示するジェスチャーを行います。
クイックアクセスウォレット UI（システム UI の一部）がパッケージマネージャーをチェックし、デフォルトの NFC 支払いアプリが QuickAccessWalletService をエクスポートするかどうかを確認します。
- サービスがエクスポートされなければ、クイックアクセスウォレットは表示されません。
クイックアクセスウォレット UI が QuickAccessWalletService にバインドして onWalletCardsRequested を呼び出します。このメソッドは、提供可能なカードの数とサイズに関するデータと、コールバックを含むリクエストオブジェクトを受け取ります。コールバックはバックグラウンドスレッドから呼び出すことができます。
QuickAccessWalletService は表示するカードを計算し、渡されたコールバックで onSuccess メソッドを呼び出します。サービスはこれらのアクションをバックグラウンドスレッドで実行することが推奨されます。
カードが表示されるとすぐにシステム UI は onWalletCardSelected を呼び出し、最初のカードが選択されたことを QuickAccessWalletService に通知します。
- onWalletCardSelected は、ユーザーが新しいカードを選択するたびに呼び出されます。
- 現在選択されているカードが変更されなくても、onWalletCardSelected が呼び出されることがあります。
ユーザーがクイックアクセスウォレットを閉じると、システム UI が onWalletDismissed を呼び出して QuickAccessWalletService に通知します。

上記の例では、ユーザーはウォレットが表示されている間に、スマートフォンを NFC 支払いデバイスにかざします。NFC 支払いを処理するための重要なコンポーネントは HostApduService です。これは、NFC リーダーによって提供される APDU を処理するために実装する必要があります（詳しくは、ホストベースのカードエミュレーションをご覧ください）。ここでは、支払いアプリによって NFC デバイスとの通信の進行状況と結果を表示するアクティビティが開始されると想定しています。しかし、クイックアクセスウォレット UI はアプリウィンドウの上に表示されます。つまり、支払いアクティビティがクイックアクセスウォレット UI によって隠されてしまいます。これを修正するため、アプリはクイックアクセスウォレット UI を閉じる必要があることをシステム UI に通知しなければなりません。そのためには、バインドされた QuickAccessWalletService への参照を取得し、イベントタイプ TYPE_NFC_PAYMENT_STARTED を使用して sendWalletServiceEvent を呼び出します。

QuickAccessWalletService 実装のサンプル

/** Sample implementation of {@link QuickAccessWalletService} */
@RequiresApi(VERSION_CODES.R)
public class MyQuickAccessWalletService extends QuickAccessWalletService {

  private static final String TAG = "QAWalletSvc";
  private ExecutorService executor;
  private PaymentCardManager paymentCardManager;

  @Override
  public void onCreate() {
    super.onCreate();
    if (Build.VERSION.SDK_INT < Build.VERSION_CODES.R) {
      Log.w(TAG, "Should not run on pre-R devices");
      stopSelf();
      return;
    }
    executor = Executors.newSingleThreadExecutor();
    paymentCardManager = new PaymentCardManager();
  }

  @Override
  public void onDestroy() {
    if (Build.VERSION.SDK_INT < Build.VERSION_CODES.R) {
      return;
    }
    executor.shutdownNow();
  }

  @Override
  public void onWalletCardsRequested(
      @NonNull GetWalletCardsRequest request, @NonNull GetWalletCardsCallback callback) {
    if (Build.VERSION.SDK_INT < Build.VERSION_CODES.R) {
      return;
    }
    executor.submit(
        () -> {
          List<PaymentCard> paymentCards = paymentCardManager.getCards();
          int maxCards = Math.min(paymentCards.size(), request.getMaxCards());
          List<WalletCard> walletCards = new ArrayList<>(maxCards);
          int selectedIndex = 0;
          int cardWidthPx = request.getCardWidthPx();
          int cardHeightPx = request.getCardHeightPx();
          for (int index = 0; index < maxCards; index++) {
            PaymentCard paymentCard = paymentCards.get(index);
            WalletCard walletCard =
                new WalletCard.Builder(
                        paymentCard.getCardId(),
                        paymentCard.getCardImage(cardWidthPx, cardHeightPx),
                        paymentCard.getContentDescription(),
                        paymentCard.getPendingIntent())
                    .build();
            walletCards.add(walletCard);
            if (paymentCard.isSelected()) {
              selectedIndex = index;
            }
          }
          GetWalletCardsResponse response =
              new GetWalletCardsResponse(walletCards, selectedIndex);
          callback.onSuccess(response);
        });
  }

  @Override
  public void onWalletCardSelected(@NonNull SelectWalletCardRequest request) {
    if (Build.VERSION.SDK_INT < Build.VERSION_CODES.R) {
      return;
    }
    executor.submit(
        () -> paymentCardManager.selectCardById(request.getCardId()));
  }

  @Override
  public void onWalletDismissed() {
    if (Build.VERSION.SDK_INT < Build.VERSION_CODES.R) {
      return;
    }
    executor.submit(() -> {
      paymentCardManager.removeCardOverrides();
    });
  }
}

QuickAccessWalletService の詳細については、QuickAccessWalletService API リファレンスをご覧ください。

権限

QuickAccessWalletService のマニフェストエントリには、Android 11 で導入された android.permission.BIND_QUICK_ACCESS_WALLET_SERVICE 権限が必要です。これはシステム UI が保持する署名レベルの権限です。つまり、システム UI プロセスのみが QuickAccessWalletService の実装にバインドできることを意味します。サイドロードされたアプリは、この権限を要求することにより、Android 10 以下を実行しているデバイスで QuickAccessWalletService データへの完全なアクセス権を取得できます。これを防ぐには、サービスが onCreate でビルドバージョンをチェックし、Android 11 以上を実行しているデバイスでのみサービスを有効にすることが推奨されます。ホストカードエミュレーション支払いサービスを提供するために必要な権限以外のアプリ権限は必要ありません。

デフォルトの NFC 支払いアプリが QuickAccessWalletService を実装していない場合またはエクスポートしない場合、クイックアクセスウォレット UI は表示されません。

Android 12 での設定

ロック画面からクイックアクセスウォレットを有効または無効にするには、[設定] > [ディスプレイ] > [ロック画面] の [ウォレットを表示] を使用します。シェード内のウォレットを無効にするには、クイック設定シェードでウォレットを手動で編集する必要があります。

ロック画面からウォレットの有効と無効を切り替える

図 5. [設定] の [ロック画面] ページにある [ウォレットを表示] の切り替え

Android 11 での設定

ユーザーは、設定アプリからクイックアクセスウォレット機能をオフにできます。設定ページは、[設定] > [システム] > [ジェスチャー] > [カードとパス] にあります。

**図 6.** クイックアクセスウォレット機能を有効または無効にする設定ページ

カスタマイズ

クイックアクセスウォレットのビューをシステム UI の別の場所に追加する

クイックアクセスウォレット UI は、システムプラグインとして構築されています。AOSP 実装では GlobalActionsDialog（長押しで表示されます）でこの UI を使用しますが、プラグインインターフェースで指定されたコントラクトを維持する限り、この機能を別のジェスチャーに移動できます。

public interface GlobalActionsPanelPlugin extends Plugin {

  /** Invoked when the view is shown */
  PanelViewController onPanelShown(Callbacks callbacks, boolean deviceLocked);

  /** Callbacks for interacting with the view container */
  interface Callbacks {
    /** Dismisses the view */
    void dismissGlobalActionsMenu();

    /** Starts a PendingIntent, dismissing the keyguard if necessary. */
    void startPendingIntentDismissingKeyguard(PendingIntent pendingIntent);
  }

  /** Provides the Quick Access Wallet view */
  interface PanelViewController {

    /** Returns the QuickAccessWallet view, which may take any size */
    View getPanelContent();

    /** Invoked when the view is dismissed */
    void onDismissed();

    /** Invoked when the device is either locked or unlocked. */
    void onDeviceLockStateChanged(boolean locked);
  }
}

クイックアクセスウォレット UI は、GlobalActionsPanelPlugin と PanelViewController を実装します。GlobalActionsDialog は、com.android.systemui.Dependency を使用してウォレットプラグインのインスタンスを取得します。

GlobalActionsPanelPlugin mPanelPlugin =
    Dependency.get(ExtensionController.class)
        .newExtension(GlobalActionsPanelPlugin.class)
        .withPlugin(GlobalActionsPanelPlugin.class)
        .build()
        .get();

プラグインが null でないことと、onPanelShown によって返された PanelViewController が null ではないことを確認した後、ダイアログはgetPanelContent によって提供された View を自身の View にアタッチし、システムイベント用の適切なコールバックを提供します。

// Construct a Wallet PanelViewController.
// `this` implements GlobalActionsPanelPlugin.Callbacks
GlobalActionsPanelPlugin.PanelViewController mPanelController =
    mPanelPlugin.onPanelShown(this, !mKeyguardStateController.isUnlocked());

// Attach the view
FrameLayout panelContainer = findViewById(R.id.my_panel_container);
FrameLayout.LayoutParams panelParams =
    new FrameLayout.LayoutParams(
        FrameLayout.LayoutParams.MATCH_PARENT,
        FrameLayout.LayoutParams.MATCH_PARENT);
panelContainer.addView(mPanelController.getPanelContent(), panelParams);

// Respond to unlock events (if the view can be accessed while the phone is locked)
keyguardStateController.addCallback(new KeyguardStateController.Callback() {
  @Override
  public void onUnlockedChanged() {
    boolean unlocked = keyguardStateController.isUnlocked()
        || keyguardStateController.canDismissLockScreen();
    mPanelController.onDeviceLockStateChanged(unlocked);
  }
});

// Implement GlobalActionsPanelPlugin.Callbacks
@Override
public void dismissGlobalActionsMenu() {
  dismissDialog();
}
@Override
public void startPendingIntentDismissingKeyguard(PendingIntent pendingIntent) {
  mActivityStarter.startPendingIntentDismissingKeyguard(pendingIntent);
}

// Notify the wallet when the container view is dismissed
mPanelController.onDismissed();

電源ボタンメニューからクイックアクセスウォレットを削除するには、システムビルドから QuickAccessWallet ターゲットを取り除きます。電源ボタンメニューからクイックアクセスウォレットを削除してシステム UI が提供する別のビューに追加するには、ビルドターゲットを組み込んで、GlobalActionsPanelPlugin への参照を GlobalActionsImpl から削除します。

デフォルト構成を設定する

Android 12

Android 12 以降では、クイックアクセスウォレットは常にクイック設定シェードに表示されます。ロック画面でクイックアクセスウォレットを表示するかどうかは、LOCKSCREEN_SHOW_WALLET という保護された設定によって制御されています。この設定により、クイックアクセスウォレットアイコンをロック画面の右下に表示するかどうかを制御します。この設定のデフォルトは true ですが、[設定] > [ディスプレイ] > [ロック画面] > [ウォレットを表示] でオフにできます。

Android 11

Android 11 では、クイックアクセスウォレットを表示するかどうかは、GLOBAL_ACTIONS_PANEL_ENABLED と GLOBAL_ACTIONS_PANEL_AVAILABLE という 2 つの保護された設定によって制御されてます。AVAILABLE 設定は、この機能を設定ページでオンまたはオフにできるかどうかを制御します。この設定は、WalletPluginService によって true に設定されています。QuickAccessWallet がビルドに含まれない場合、設定は false のままです。同じ場所で、ENABLED 設定はデフォルトで true に設定されていますが、ユーザーは設定ページでオフにできます。デフォルトの動作を変更するには、WalletPluginService#enableFeatureInSettings を変更します。

検証

クイックアクセスウォレットの実装を検証するには、CTS テストと手動テストを実施します。プラグインを変更した場合は、付属の robolectric テストも実施する必要があります。

CTS テスト

cts/tests/quickaccesswallet にある CTS テストを実施します。

Android 12 向けの手動テスト

クイックアクセスウォレットのコア機能をテストするには、NFC 支払いデバイス（本物または偽物）と、QuickAccessWalletService を実装した NFC 支払いアプリ（ウォレットアプリ）が必要です。テストが必要なコア機能には、可用性、ゼロ状態、カード選択、ロック画面の動作などがあります。

可用性

デフォルトの NFC 支払いアプリがこの機能をサポートしていない場合、クイック設定とロック画面のどちらでもクイックアクセスウォレットを利用できません。
デフォルトの NFC 支払いアプリがこの機能をサポートしている場合、クイックアクセスウォレットはクイック設定シェードで利用できます。
デフォルトの NFC 支払いアプリがこの機能をサポートしていて、LOCKSCREEN_SHOW_WALLET 設定が true であれば、ロック画面でクイックアクセスウォレットを利用できます。
デフォルトの NFC 支払いアプリがこの機能をサポートしていて、LOCKSCREEN_SHOW_WALLET 設定が false であれば、ロック画面でクイックアクセスウォレットを利用できません。

ゼロ状態

QuickAccessWalletService が有効になっていてエクスポートされているがカードを提供していない場合、図 7 の例に示すように、シェードにタイルが表示されます。タイルをクリックすると、デフォルトの NFC 支払いアプリが開きます。

図 7. デフォルトの NFC 支払いアプリを表示しているシェード内のタイルの例
図 8 のような空の状態のビューをクリックすると、デフォルトの NFC 支払いアプリが開きます。この空の状態のビューは、ユーザーがウォレットにカードを 1 枚残し、カードの詳細ページからそのカードを削除した後、ウォレットビューに戻った場合にのみ表示されます。
ロック画面にウォレットアイコンが表示されます。

クイックアクセスウォレットの空の状態のビュー

図 8. クイックアクセスウォレット UI の空の状態のビュー

ゼロでない状態

ウォレットアプリが 1 つ以上のカードを提供している場合、図 9 のように、シェードにタイルが表示されます。

図 9. ウォレットにカードが 1 枚以上ある場合のシェード内のタイルの例
タイルをクリックすると、カードカルーセルが表示されます。
ロック画面にクイックアクセスウォレットを開くボタンが表示されます。

図 10. カードが表示されたクイックアクセスウォレット UI
表示されたカードが NFC 支払い方法を表している場合、スマートフォンを NFC 支払いデバイスにかざすと、その支払い方法が使用され、ウォレットビューが閉じます。
表示されたカードをクリックすると、そのカードの詳細アクティビティが表示されます。
QuickAccessWalletService によって複数のカードが提供されている場合、ユーザーはカード間をスワイプできます。
オーバーフローメニューには 1 つのエントリがあります（ロック画面の設定を開き、ユーザーが [ウォレットを表示] を変更できるようにします）。

ロック状態のテスト

スマートフォンがロックされている場合は、クイック設定シェードにウォレットが表示されます。このとき、デフォルトの支払いアプリにカードが存在しない場合は [カードを追加する] という説明が表示され、デフォルトの支払いアプリにカードが存在する場合は [ロックを解除して使用] という説明が表示されます。
スマートフォンがロックされている場合、ロック画面にウォレットを表示するかどうかは Secure.LOCKSCREEN_SHOW_WALLET 設定（設定画面で管理）によって制御されます。
スマートフォンがロックされていて、LOCKSCREEN_SHOW_WALLET が false で、デフォルトの NFC 支払いアプリにカードが存在しない場合、ロック画面にウォレットは表示されません。
スマートフォンがロックされていて、LOCKSCREEN_SHOW_WALLET が true で、デフォルトの NFC 支払いアプリにカードが存在しない場合、ロック画面にウォレットは表示されません。
スマートフォンがロックされていて、LOCKSCREEN_SHOW_WALLET が true で、デフォルトの NFC 支払いアプリにカードが存在する場合、ロック画面にウォレットが表示されます。
ウォレットがロック画面に表示されているときにスマートフォンのロックを解除すると、カードが再度クエリされ、異なるカードコンテンツが作成されることがあります。

ユーザー補助機能のテスト

TalkBack のユーザーは、左右のスワイプを行い、カードの内容説明を聞くことにより、ウォレットビューを操作できます。
TalkBack を有効にして左右にスワイプすると、各カードが順番に選択されます。TalkBack のユーザーは、NFC 支払いデバイスで NFC 支払い方法を選択して使用できます。

Android 11 向けの手動テスト

可用性

GLOBAL_ACTIONS_PANEL_ENABLED 設定が true で、デフォルトの NFC 支払いアプリがこの機能をサポートしている場合、クイックアクセスウォレットは利用可能です。
GLOBAL_ACTIONS_PANEL_ENABLED 設定が false で、デフォルトの NFC 支払いアプリがこの機能をサポートしている場合、クイックアクセスウォレットは利用不可です。
GLOBAL_ACTIONS_PANEL_ENABLED 設定が true で、デフォルトの NFC 支払いアプリがこの機能をサポートしていない場合、クイックアクセスウォレットは利用不可です。
GLOBAL_ACTIONS_PANEL_ENABLED 設定が false で、デフォルトの NFC 支払いアプリがこの機能をサポートしていない場合、クイックアクセスウォレットは利用不可です。

ゼロ状態

QuickAccessWalletService が有効になっていてエクスポートされているがカードを提供していない場合、クイックアクセスウォレット UI は空の状態のビューを表示します。
空の状態のビューをクリックすると、ウォレットアプリが開きます。

図 11. クイックアクセスウォレット UI の空の状態のビュー

ゼロでない状態

ウォレットアプリが 1 つ以上のカードを提供している場合、クイックアクセスウォレット UI にカードが表示されます。

図 12. カードが表示されたクイックアクセスウォレット
表示されたカードが NFC 支払い方法を表している場合、スマートフォンを NFC 支払いデバイスにかざすと、その支払い方法が使用され、ウォレットビューが閉じます。
表示されたカードをクリックすると、ウォレットビューが閉じて、そのカードの詳細アクティビティが開きます。
QuickAccessWalletService によって複数のカードが提供されている場合、ユーザーはカード間をスワイプできます。
オーバーフローメニューには 2 つのエントリが表示されます。1 つはウォレットアプリを開くエントリで、もう 1 つは設定ページの [カードとパスの表示] 画面を開くエントリです。

ロック状態のテスト

スマートフォンがロックされている場合、ウォレットの可視性は Settings.Secure.POWER_MENU_LOCK_SHOW_CONTENT 設定によって制御されます。これは設定ページで管理できます。
スマートフォンがロックされていて POWER_MENU_LOCK_SHOW_CONTENT が false の場合、ウォレットは表示されません。
スマートフォンがロックされていて、POWER_MENU_LOCK_SHOW_CONTENT が true の場合、ウォレットは表示されます。
ウォレットがロック画面に表示されているときにスマートフォンのロックを解除すると、カードが再度クエリされ、異なるカードコンテンツが作成されることがあります。

ユーザー補助機能のテスト

TalkBack のユーザーは、左右のスワイプを行い、カードの内容説明を聞くことにより、ウォレットビューを操作できます。
TalkBack を有効にして左右にスワイプすると、各カードが順番に選択されます。TalkBack のユーザーは、NFC 支払いデバイスで NFC 支払い方法を選択して使用できます。

クイック アクセス ウォレット

要件

機能の概要

実装

Android 11 でクイック アクセス ウォレット UI を有効にする

QuickAccessWalletService 実装の詳細

QuickAccessWalletService 実装のサンプル

権限

Android 12 での設定

Android 11 での設定

カスタマイズ

クイック アクセス ウォレットのビューをシステム UI の別の場所に追加する

デフォルト構成を設定する

Android 12

Android 11

検証

CTS テスト

Android 12 向けの手動テスト

可用性

ゼロ状態

ゼロでない状態

ロック状態のテスト

ユーザー補助機能のテスト

Android 11 向けの手動テスト

可用性

ゼロ状態

ゼロでない状態

ロック状態のテスト

ユーザー補助機能のテスト

クイックアクセスウォレット

Android 11 でクイックアクセスウォレット UI を有効にする

クイックアクセスウォレットのビューをシステム UI の別の場所に追加する