Google berkomitmen untuk mendorong terwujudnya keadilan ras bagi komunitas Kulit Hitam. Lihat caranya.

Dompet Akses Cepat

Fitur Dompet Akses Cepat, tersedia dari Android 11, memungkinkan pengguna untuk mengakses kartu pembayaran dan tiket yang relevan langsung dari menu daya. Kasus penggunaan utama termasuk memilih metode pembayaran yang sesuai sebelum melakukan transaksi di terminal NFC dan dengan cepat mengakses penerbangan dan tiket lainnya untuk acara mendatang.

Fitur Dompet Akses Cepat di menu daya
Gambar 1. Fitur Dompet Akses Cepat di menu daya

Persyaratan

Perangkat Anda harus memiliki NFC untuk menggunakan fitur Dompet Akses Cepat. Fitur tersebut mengikat QuickAccessWalletService dari aplikasi pembayaran NFC default, yang berarti bahwa perangkat tersebut juga harus mendukung emulasi kartu berbasis host (HCE) NFC.

Ringkasan fitur

Ada dua bagian dari Dompet Akses Cepat: UI Dompet Akses Cepat dan penyedia kartu Dompet Akses Cepat.

UI Wallet berjalan di UI Sistem dan diimplementasikan di platform/packages/apps/QuickAccessWallet . Selain memasukkan dan membuat daftar putih paket dan memasang penyedia kartu Dompet Akses Cepat, tidak ada perubahan tambahan yang diperlukan untuk membuat UI Wallet muncul di menu daya.

Penyedia kartu Quick Access Wallet adalah aplikasi pembayaran NFC default. Pengguna dapat menginstal beberapa aplikasi pembayaran NFC secara bersamaan, tetapi hanya aplikasi pembayaran NFC default yang dapat menampilkan kartu di menu daya. Anda dapat menentukan aplikasi pembayaran NFC mana yang pada awalnya disetel sebagai default , tetapi pengguna dapat memilih aplikasi yang berbeda di Pengaturan. Jika hanya satu aplikasi pembayaran NFC yang diinstal, itu menjadi default secara otomatis (lihat CardEmulationManager ).

Penerapan

Untuk memberikan kartu ke UI Dompet Akses Cepat, aplikasi pembayaran NFC harus menerapkan QuickAccessWalletService . Aplikasi pembayaran harus menyertakan entri manifes yang mengiklankan layanan.

Untuk memastikan bahwa hanya UI Sistem yang dapat mengikat ke QuickAccessWalletService , aplikasi pembayaran NFC harus memerlukan izin android.permission.BIND_QUICK_ACCESS_WALLET_SERVICE . Mewajibkan izin ini memastikan bahwa hanya UI Sistem yang dapat mengikat ke 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" />;
 </service>

Informasi tambahan tentang dompet disertakan dalam file XML yang ditautkan:

<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"/>

Selanjutnya, aplikasi pembayaran harus mengimplementasikan 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
    }
}

Jika HostApduService mulai menangani transaksi NFC dan, sebagai konsekuensinya, memulai aktivitas untuk menampilkan kemajuan dan hasil pembayaran, itu juga harus mencoba untuk mendapatkan referensi ke QuickAccessWalletService terikat dan memanggil QuickAccessWalletService#sendEvent dengan jenis peristiwa TYPE_NFC_PAYMENT_STARTED . Hal ini menyebabkan UI Dompet Akses Cepat ditutup, sehingga memungkinkan pengguna untuk melihat aktivitas pembayaran tanpa halangan.

Untuk dokumentasi tambahan tentang penerapan QuickAccessWalletService , lihat QuickAccessWalletService dan uji CTS TestQuickAccessWalletService .

Mengaktifkan UI Dompet Akses Cepat

Untuk mengonfigurasi Quick Access Wallet agar tersedia dari menu daya, sertakan target QuickAccessWallet di build dan aktifkan plugin globalactions.wallet dengan menambahkan baris yang dicetak tebal dalam contoh kode di bawah ini ke overlay/frameworks/base/packages/SystemUI/res/values/config.xml file.

<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>
.dll

Tentukan aplikasi pembayaran NFC default di file konfigurasi pengaturan menggunakan def_nfc_payment_component .

Aplikasi pembayaran NFC default harus mengekspos QuickAccessWalletService untuk menyediakan kartu ke Dompet Akses Cepat. Jika aplikasi pembayaran NFC default tidak mengekspor layanan ini, UI dompet disembunyikan.

Detail implementasi QuickAccessWalletService

QuickAccessWalletService memiliki tiga metode abstrak yang harus diterapkan: onWalletCardsRequested , onWalletCardSelected , dan onWalletDismissed . Diagram urutan di bawah mengilustrasikan urutan panggilan ketika Dompet Akses Cepat dilihat tepat sebelum pembayaran NFC.

Diagram urutan Dompet Akses Cepat

Contoh urutan panggilan saat Quick Access Wallet dilihat
Gambar 2. Contoh urutan panggilan saat Quick Access Wallet ditampilkan

Tidak semua tampilan Quick Access Wallet diikuti dengan pembayaran NFC, tetapi gambar 2 di atas menggambarkan semua kemampuan QuickAccessWalletService . Dalam contoh ini, penyedia kartu Dompet Akses Cepat mengimplementasikan elemen yang diuraikan dengan warna biru. Diasumsikan bahwa kartu pembayaran disimpan di perangkat dalam database dan diakses melalui antarmuka bernama PaymentCardManager . Selanjutnya diasumsikan bahwa aktivitas yang disebut PaymentActivity menampilkan hasil pembayaran NFC. Aliran berlangsung sebagai berikut:

  1. Pengguna melakukan gerakan untuk membuka Dompet Akses Cepat.
  2. UI Dompet Akses Cepat (bagian dari UI Sistem) memeriksa pengelola paket untuk melihat apakah aplikasi pembayaran NFC default mengekspor QuickAccessWalletService .

    • Jika layanan tidak diekspor, Dompet Akses Cepat tidak ditampilkan.
  3. UI Quick Access Wallet mengikat QuickAccessWalletService dan memanggil onWalletCardsRequested . Metode ini mengambil objek permintaan yang berisi data tentang jumlah dan ukuran kartu yang dapat disediakan dan callback. Callback dapat dipanggil dari thread latar belakang.

  4. QuickAccessWalletService menghitung kartu yang ingin ditampilkan, lalu memanggil metode onSuccess pada callback yang disediakan. Direkomendasikan agar layanan melakukan tindakan ini pada thread latar belakang.

  5. Segera setelah kartu ditampilkan, UI Sistem memberi tahu QuickAccessWalletService bahwa kartu pertama telah dipilih dengan memanggil onWalletCardSelected .

    • onWalletCardSelected dipanggil setiap kali pengguna memilih kartu baru.
    • onWalletCardSelected mungkin dipanggil meskipun kartu yang saat ini dipilih tidak berubah.
  6. Saat pengguna menutup Quick Access Wallet, UI Sistem memberi tahu QuickAccessWalletService dengan memanggil onWalletDismissed .

Dalam contoh di atas, pengguna membawa ponsel ke dalam jangkauan terminal pembayaran NFC saat dompet sedang ditampilkan. Komponen utama penanganan pembayaran NFC adalah HostApduService , yang harus diterapkan untuk memproses APDU yang disediakan oleh pembaca NFC (untuk informasi lebih lanjut, lihat Emulasi kartu berbasis Host ). Diasumsikan bahwa aplikasi pembayaran memulai aktivitas untuk menampilkan kemajuan dan hasil interaksi dengan terminal NFC. Namun, UI Dompet Akses Cepat ditampilkan di atas jendela aplikasi, yang berarti bahwa aktivitas pembayaran dikaburkan oleh UI Dompet Akses Cepat. Untuk memperbaikinya, aplikasi harus memberi tahu UI Sistem bahwa UI Dompet Akses Cepat harus ditutup. Itu bisa dilakukan dengan mendapatkan referensi ke QuickAccessWalletService terikat dan memanggil sendWalletServiceEvent dengan jenis kejadian TYPE_NFC_PAYMENT_STARTED .

Contoh implementasi 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();
    });
  }
}

Untuk detail lebih lanjut tentang QuickAccessWalletService , lihat referensi QuickAccessWalletService API .

Izin

Entri manifes untuk QuickAccessWalletService harus memerlukan izin android.permission.BIND_QUICK_ACCESS_WALLET_SERVICE diperkenalkan di Android 11. Ini adalah izin tingkat tanda tangan yang dipegang oleh UI Sistem, yang berarti bahwa hanya proses UI Sistem yang dapat mengikat ke implementasi QuickAccessWalletService . Ketahuilah bahwa aplikasi yang dimuat samping dapat mengklaim izin ini dan mendapatkan akses penuh ke data QuickAccessWalletService pada perangkat yang menjalankan Android 10 atau lebih rendah. Untuk mencegahnya, sebaiknya layanan memeriksa versi build di onCreate dan mengaktifkan layanan hanya di perangkat yang menjalankan Android 11 dan lebih tinggi. Tidak ada izin aplikasi lain yang diperlukan selain yang diperlukan untuk menyediakan layanan pembayaran emulasi kartu host.

Jika aplikasi pembayaran NFC default tidak menerapkan atau mengekspor QuickAccessWalletService , UI Dompet Akses Cepat tidak ditampilkan.

Pengaturan

Pengguna dapat mematikan fitur Dompet Akses Cepat dari aplikasi Pengaturan. Halaman pengaturan ada di Settings > System > Gestures > Cards & pass .

Halaman pengaturan untuk mengaktifkan atau menonaktifkan fitur Dompet Akses Cepat
Gambar 3. Halaman Pengaturan untuk mengaktifkan atau menonaktifkan fitur Dompet Akses Cepat

Kustomisasi

Menambahkan tampilan Dompet Akses Cepat ke lokasi lain di UI Sistem

UI Dompet Akses Cepat dibuat sebagai plugin sistem . Meskipun implementasi AOSP memanfaatkannya di GlobalActionsDialog (ditampilkan pada tekan daya lama), Anda dapat memindahkan fitur di belakang isyarat yang berbeda selama Anda mempertahankan kontrak yang ditentukan oleh antarmuka plugin.

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 Dompet Akses Cepat mengimplementasikan GlobalActionsPanelPlugin dan PanelViewController . GlobalActionsDialog mendapatkan instance dari plugin wallet dengan menggunakan com.android.systemui.Dependency :

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

Setelah memeriksa bahwa plugin bukan null dan PanelViewController dikembalikan oleh onPanelShown bukan null, dialog akan melampirkan View disediakan oleh getPanelContent ke View -nya sendiri dan menyediakan callback yang sesuai untuk peristiwa sistem.

// 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();

Untuk menghapus Quick Access Wallet dari menu daya, abaikan target QuickAccessWallet dari sistem build. Untuk menghapus Dompet Akses Cepat dari menu daya tetapi menambahkannya ke tampilan berbeda yang disediakan oleh UI Sistem, sertakan target build dan hapus referensi ke GlobalActionsPanelPlugin dari GlobalActionsImpl .

Menyetel konfigurasi default

Visibilitas Dompet Akses Cepat GLOBAL_ACTIONS_PANEL_ENABLED oleh dua setelan aman: GLOBAL_ACTIONS_PANEL_ENABLED dan GLOBAL_ACTIONS_PANEL_AVAILABLE . Pengaturan AVAILABLE mengontrol apakah fitur dapat dihidupkan dan dimatikan dalam Pengaturan. Pengaturan ini disetel ke true oleh WalletPluginService . Jika QuickAccessWallet tidak disertakan dalam build, maka pengaturannya tetap false . Pengaturan ENABLED diatur ke true secara default di tempat yang sama, tetapi dapat dinonaktifkan oleh pengguna di Pengaturan. Untuk mengubah perilaku default, ubah WalletPluginService#enableFeatureInSettings .

Validasi

Untuk memvalidasi implementasi Anda dari Dompet Akses Cepat, jalankan CTS dan tes manual. Perubahan pada plugin juga harus melakukan pengujian robolectric yang disertakan.

Tes CTS

Jalankan tes CTS yang terletak di cts/tests/quickaccesswallet .

Tes manual

Menguji fitur inti Dompet Akses Cepat memerlukan terminal pembayaran NFC (asli atau palsu) dan aplikasi pembayaran NFC yang mengimplementasikan QuickAccessWalletService (aplikasi dompet). Fitur inti yang harus diuji meliputi ketersediaan, status nol, pemilihan kartu, dan perilaku layar kunci.

Ketersediaan

  • Jika setelan GLOBAL_ACTIONS_PANEL_ENABLED true dan aplikasi pembayaran NFC default mendukung fitur tersebut, Dompet Akses Cepat dapat diakses.
  • Jika setelan GLOBAL_ACTIONS_PANEL_ENABLED false dan aplikasi pembayaran NFC default mendukung fitur tersebut, Dompet Akses Cepat tidak dapat diakses.
  • Jika setelan GLOBAL_ACTIONS_PANEL_ENABLED true dan aplikasi pembayaran NFC default tidak mendukung fitur tersebut, Dompet Akses Cepat tidak dapat diakses.
  • Jika setelan GLOBAL_ACTIONS_PANEL_ENABLED false dan aplikasi pembayaran NFC default tidak mendukung fitur tersebut, Dompet Akses Cepat tidak dapat diakses.

Status nol

  • Jika QuickAccessWalletService diaktifkan dan diekspor tetapi tidak menyediakan kartu apa pun, UI Dompet Akses Cepat menampilkan tampilan status kosong.
  • Mengklik tampilan status kosong membuka aplikasi dompet.

    Tampilan status kosong di UI Dompet Akses Cepat
    Gambar 4. Tampilan status kosong di UI Dompet Akses Cepat

Status bukan nol

  • Jika aplikasi dompet menyediakan satu atau beberapa kartu, kartu-kartu tersebut akan ditampilkan di UI Dompet Akses Cepat.

    Akses Cepat Dompet UI dengan kartu ditampilkan
    Gambar 5. UI Dompet Akses Cepat dengan kartu yang ditampilkan
  • Jika kartu yang ditampilkan mewakili metode pembayaran NFC, mendekatkan ponsel ke terminal pembayaran NFC mengakibatkan metode pembayaran tersebut digunakan dan tampilan dompet ditutup.

  • Mengklik kartu yang ditampilkan menutup tampilan dompet dan membuka aktivitas rinci untuk kartu itu.

  • Jika beberapa kartu disediakan oleh QuickAccessWalletService , pengguna dapat menggeser antar kartu.

  • Menu luapan berisi dua entri: satu yang membuka aplikasi dompet dan satu lagi yang membuka layar Tampilkan kartu & lewat di Pengaturan.

Tes status kunci

  • Jika ponsel terkunci, visibilitas dompet dikontrol oleh pengaturan Settings.Secure.POWER_MENU_LOCK_SHOW_CONTENT , yang dapat dikontrol di Settings.
  • Jika telepon terkunci dan POWER_MENU_LOCK_SHOW_CONTENT false , dompet tidak ditampilkan.
  • Jika telepon terkunci dan POWER_MENU_LOCK_SHOW_CONTENT true , dompet akan ditampilkan.
  • Membuka kunci ponsel saat dompet sedang ditampilkan di layar kunci mengakibatkan kartu dipertanyakan kembali, yang mungkin menghasilkan konten kartu yang berbeda.

Tes aksesibilitas

  • Pengguna TalkBack dapat menavigasi tampilan dompet dengan menggesek ke kiri dan kanan dan dengan mendengarkan deskripsi konten kartu.
  • Menggesek ke kiri dan kanan dengan TalkBack diaktifkan akan memilih setiap kartu secara bergantian. Pengguna TalkBack dapat memilih dan menggunakan metode pembayaran NFC di terminal pembayaran NFC.