Alur orientasi pengguna akhir di Android

Panduan ini memberikan panduan UX untuk mendesain izin perangkat dan berbagi Google Home API yang lancar untuk pengalaman orientasi di aplikasi Anda.

Topik utama yang dijelaskan di sini adalah:

• Mengapa harus berbagi perangkat dengan Google Home?
• Fase utama alur berbagi
• Implementasi teknis
• Praktik terbaik UX

Mengapa harus berbagi perangkat dengan Google Home?

Untuk menikmati kemampuan yang ditawarkan Home API, pengguna harus berbagi perangkat mereka dengan Google Home karena:

• Ini adalah persyaratan teknis agar Google dapat menggunakan perangkat ini dalam otomatisasi.
• Hal ini membantu mempertahankan pengalaman Google Home yang konsisten dan fleksibel.
  • Memastikan perangkat ditampilkan secara konsisten di seluruh aplikasi yang mendukung Home API sangat penting untuk menghindari pembuatan pengalaman pengguna yang terfragmentasi dan membingungkan, yang mengharuskan pengguna berpindah-pindah aplikasi untuk menyelesaikan tugas dasar.

Komponen utama alur berbagi

Komponen	Program	Deskripsi
Permissions API di Android	Home API untuk Izin di Android	Mendorong pengguna untuk memberikan izin ke aplikasi Anda. Sebelum menggunakan Home API, aplikasi Anda harus memiliki izin untuk mengakses perangkat di rumah pengguna (disebut dalam API sebagai struktur). Namun, urutan langkah ini dilakukan bergantung pada skenario developer, dan disertakan dalam Implementasi teknis.
Penautan cloud ke cloud	Cloud ke cloud untuk penautan akun	Memungkinkan Anda memulai proses penautan akun untuk berbagi perangkat yang terhubung ke cloud dengan Google Home dari dalam aplikasi Anda. Untuk mengurangi hambatan pengguna, sebaiknya gunakan kemampuan deep link (tersedia di Android dan iOS) yang mengarahkan pengguna langsung ke halaman penautan akun tertentu di GHA.
Commissioning API di Android	Commissioning Matter	Meskipun umumnya dianggap sebagai API untuk mengaktifkan perangkat Matter baru Matter, Anda juga dapat menggunakan API ini untuk menambahkan fabric Google ke Matter perangkat yang telah diaktifkan ke fabric lain. Oleh karena itu, ini adalah alat yang berguna untuk proses orientasi.

Implementasi teknis

Cara Anda membuat alur berbagi bergantung pada perangkat yang Anda rencanakan untuk dibagikan kepada Google.

Untuk skenario berikut, sebaiknya ikuti langkah-langkah dalam urutan yang diberikan. Hal ini membantu memberikan pengalaman keseluruhan yang lebih baik kepada pengguna.

Anda hanya memproduksi perangkat Matter

Anda memproduksi perangkat yang mendukung Matter yang ingin Anda aktifkan ke Google Home.

1. Panggil Permissions API di Android.

2. Panggil Commissioning API di Android di setiap Matter perangkat yang sebelumnya diaktifkan ke fabric lain.

   1. Karena berbagi Matter harus dilakukan untuk setiap perangkat satu per satu, dan ada banyak layar yang memerlukan input pengguna, sebaiknya pandu pengguna melalui proses ini dengan:
      • Memberikan daftar perangkat Matter yang tidak dibagikan kepada Google.
      • Mengizinkan pengguna memulai proses berbagi perangkat (menggunakan Commissioning API) dengan mengklik perangkat dalam daftar tersebut.
      • Kembali ke daftar perangkat Matter, yang menampilkan progres tugas dan status berbagi kepada pengguna.

Anda hanya memproduksi perangkat yang dibagikan kepada Google menggunakan Cloud-to-cloud API

1. Lakukan Cloud-to-cloud deep linking. Tindakan ini akan menambahkan perangkat ke Google Home Graph.

   1. Sebaiknya lakukan Cloud-to-cloud penautan terlebih dahulu untuk menghindari situasi yang berpotensi membingungkan seperti pengguna yang melihat daftar yang berisi perangkat yang dibagikan kepada Google dan perangkat yang tidak dibagikan kepada Google.

2. Panggil Permissions API di Android.

Anda memproduksi perangkat Cloud-to-cloud dan Matter

1. Lakukan Cloud-to-cloud deep linking.

   1. Sebaiknya lakukan Cloud-to-cloud penautan terlebih dahulu untuk menghindari situasi yang berpotensi membingungkan seperti pengguna yang melihat daftar yang berisi perangkat yang dibagikan kepada Google dan perangkat yang tidak dibagikan kepada Google.

2. Panggil Permissions API di Android.

3. Panggil Commissioning API untuk Android di setiap Matter perangkat yang sebelumnya diaktifkan ke fabric lain.

   1. Karena berbagi Matter harus dilakukan untuk setiap perangkat satu per satu, dan ada banyak layar yang memerlukan input pengguna, sebaiknya pandu pengguna melalui proses ini dengan:
      • Memberikan daftar perangkat Matter yang tidak dibagikan kepada Google.
      • Mengizinkan pengguna memulai proses berbagi perangkat (menggunakan Commissioning API) dengan mengklik perangkat dalam daftar tersebut.
      • Kembali ke daftar perangkat Matter, yang menampilkan progres tugas dan status berbagi kepada pengguna.

Anda tidak memiliki perangkat untuk dibagikan kepada Google

Panggil Permissions API.

Praktik terbaik UX

Bagian ini berisi beberapa perjalanan pengguna penting yang perlu dipertimbangkan saat mengembangkan aplikasi yang memanfaatkan Home API.

Tempat untuk memperkenalkan berbagi perangkat di aplikasi

Ini bukan daftar lengkap, dan Anda mungkin menemukan peluang lain untuk memberikan pengalaman berbagi dan penawaran Google Home yang tepat waktu kepada pengguna.

Hal ini juga tidak saling eksklusif, dan ada beberapa titik masuk:

Dari menu Setelan

Karena pengguna mungkin terbiasa menyiapkan koneksi dengan ekosistem Google Home mereka melalui menu setelan, metode ini memungkinkan mereka melanjutkan paradigma ini.

Anda mungkin ingin memisahkan berbagi perangkat (Cloud-to-cloud penautan dan Commissioning API Matter) dari pemberian izin aplikasi (Permissions API). Hal ini memberi pengguna kemampuan untuk mengontrol langkah-langkah yang mereka selesaikan, dan memberi Anda peluang untuk menampilkan status koneksi kepada pengguna.

Saat menggunakan perangkat dalam otomatisasi yang dijalankan oleh Google

Dari tab Otomatisasi, pengguna dapat mengetuk titik masuk ke alur berbagi, membaca layar proposisi nilai yang menjelaskan dengan jelas manfaat melanjutkan, lalu dengan cepat berpindah ke alur izin.

Hanya dari commissioning

Skenario ini terutama ditujukan untuk partner yang hanya memproduksi perangkat Matter (tidak ada Cloud-to-cloud perangkat) dan tidak memiliki Matter fabric sendiri. Titik masuk untuk pengguna dapat muncul tepat setelah layar jenis out-of-box, tempat berbagi perangkat Matter (melalui Commissioning API) dan pemberian izin aplikasi (melalui Permissions API) merupakan bagian dari alur pengalaman pengguna yang sama.

Logika berbagi

Beberapa saran tentang perintah pengguna adalah:

• Anda umumnya harus meminta pengguna untuk hanya menyelesaikan langkah-langkah yang diperlukan untuk melakukan orientasi platform. Misalnya, pelanggan lama mungkin sudah berbagi perangkat OEM dengan Google, sehingga mereka hanya perlu melalui proses pemberian izin Home API untuk memberikan akses aplikasi ke Google Home mereka.

• Beberapa administrator Google Home mungkin berbagi struktur Google Home, dan dalam beberapa kasus, hanya satu akun yang dapat digunakan untuk berbagi perangkat dengan Google. Oleh karena itu, menyelesaikan penautan Cloud-to-cloud tidak boleh menjadi prasyarat untuk meminta izin Home API.

Saran desain visual

• Manfaat yang jelas dari orientasi ke Google Home (misalnya, "Buat otomatisasi lanjutan yang didukung oleh Google Home" atau "Kontrol perangkat menggunakan aplikasi pilihan Anda").

• Tombol ajakan (misalnya, "Mulai") dan cara untuk membatalkan jika pengguna tidak ingin melanjutkan.

• Jika ada ruang, penjelasan tentang apa yang akan terjadi saat pengguna melanjutkan ke layar berikutnya.

• Khusus untuk Matter, jika pengguna sebelumnya telah memberikan akses ke rumah mereka melalui Home API, Anda dapat memungkinkan mereka berbagi perangkat di rumah mereka dengan Google Home saat mengaktifkan perangkat baru. Misalnya, Anda dapat menambahkan Matter perangkat ke fabric Anda, lalu meminta pengguna untuk menambahkan perangkat ini ke fabric Google.

Saran konten

Pengguna lebih mudah mempercayai sesuatu yang mereka pahami dan memberikan nilai tambah. Berikan informasi kepada pengguna untuk membuat keputusan yang tepat, termasuk pertimbangan.

Penawaran penting

Pengguna tidak akan melanjutkan berbagi perangkat jika tidak ada proposisi nilai yang kuat untuk melakukannya.

• Perhatikan dengan cermat cara Anda memposisikan penawaran.
• Buat penawaran yang menarik, tetapi jangan berlebihan.
• Jika pengguna memerlukan perangkat yang disebutkan dalam penawaran Anda, pastikan hal tersebut dinyatakan dengan jelas agar mereka tidak mengalami hambatan yang tidak terduga.
• Anda mungkin hanya memiliki satu peluang untuk mendapatkan pengguna ini, jadi manfaatkan peluang tersebut.

Praktik terbaik

1. Mulai dari sudut pandang pengguna - pendekatan "apa manfaatnya bagi saya?".
2. Jangan tulis lebih dari empat baris konten dalam blok bagian. Terlalu banyak kata dapat mengalihkan perhatian pengguna. Namun, kejelasan dan pemahaman bisa lebih penting daripada ringkas.
3. Otomatisasi itu menyenangkan. Pilih contoh yang menarik tetapi bermanfaat jika ada ruang.
4. Coba gunakan gaya bahasa yang menyenangkan jika sesuai dengan strategi keseluruhan Anda.
5. Gunakan frasa yang dapat ditindaklanjuti seperti "Mulai".