Alur orientasi pengguna akhir di Android

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

Topik utama yang dijelaskan di sini adalah:

• Mengapa Anda harus berbagi perangkat dengan Google Home?
• Tahapan utama alur berbagi
• Penerapan teknis
• Praktik terbaik UX

Mengapa membagikan perangkat ke Google Home?

Untuk menikmati kemampuan yang ditawarkan Home API, pengguna harus membagikan perangkat mereka ke 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 kompatibel dengan Home API sangat penting untuk menghindari pengalaman pengguna yang terfragmentasi dan membingungkan, di mana pengguna harus berpindah-pindah antar-aplikasi untuk menyelesaikan tugas-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 salah satu Home API, aplikasi Anda harus memiliki izin untuk mengakses perangkat di rumah pengguna (disebut dalam API sebagai struktur). Urutan langkah ini dilakukan, bergantung pada skenario developer, dan disertakan dalam Penerapan teknis.
Penautan cloud-to-cloud	Cloud-to-cloud untuk penautan akun	Memungkinkan Anda memulai proses penautan akun untuk membagikan perangkat yang terhubung ke cloud dengan Google Home dari dalam aplikasi Anda. Untuk mengurangi gesekan 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	Penyiapan Matter	Meskipun umumnya dianggap sebagai API untuk mengaktifkan perangkat baru, Anda juga dapat menggunakan API ini untuk menambahkan kain Google ke perangkat yang telah diaktifkan ke kain lain.MatterMatter 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 berbagi dengan Google.

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

Anda hanya memproduksi perangkat Matter

Anda memproduksi perangkat yang kompatibel dengan Matter yang ingin Anda aktifkan di Google Home.

1. Panggil Permissions API di Android.

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

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

Anda hanya membuat perangkat yang dibagikan ke Google menggunakan API Cloud-to-cloud

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

   1. Sebaiknya lakukan penautan Cloud-to-cloud terlebih dahulu untuk menghindari situasi yang berpotensi membingungkan seperti pengguna disajikan dengan daftar yang berisi perangkat yang dibagikan ke Google dan perangkat yang tidak dibagikan ke 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 penautan Cloud-to-cloud terlebih dahulu untuk menghindari situasi yang berpotensi membingungkan seperti pengguna disajikan dengan daftar yang berisi perangkat yang dibagikan ke Google dan perangkat yang tidak dibagikan ke Google.

2. Panggil Permissions API di Android.

3. Panggil Commissioning API for Android di setiap perangkat Matter yang sebelumnya di-commissioning ke fabric lain.

   1. Karena berbagi Matter harus dilakukan untuk setiap perangkat secara terpisah, dan ada banyak layar yang memerlukan input pengguna, sebaiknya Anda memandu pengguna melalui proses ini dengan:
      • Memberi pengguna daftar perangkat Matter yang tidak dibagikan ke Google.
      • Memungkinkan pengguna memulai proses berbagi perangkat (menggunakan Commissioning API) dengan mengklik perangkat dalam daftar tersebut.
      • Kembali ke daftar perangkat Matter, 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 penting pengguna yang perlu dipertimbangkan saat mengembangkan aplikasi yang memanfaatkan Home API.

Tempat untuk memperkenalkan fitur berbagi perangkat di aplikasi

Ini bukan daftar lengkap, dan Anda dapat menemukan peluang lain untuk memberikan saran dan pengalaman berbagi Google Home yang tepat waktu bagi pengguna Anda.

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 dengan paradigma ini.

Anda mungkin ingin memisahkan berbagi perangkat (penautan Cloud-to-cloud 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 kesempatan untuk menampilkan status koneksi kepada pengguna.

Saat menggunakan perangkat dalam otomatisasi yang dijalankan oleh Google

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

Hanya dari komisioning

Skenario ini terutama ditujukan bagi partner yang hanya memproduksi perangkat Matter (tanpa perangkat Cloud-to-cloud) dan tidak memiliki fabric Matter sendiri. Titik entri 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 hanya boleh meminta pengguna untuk menyelesaikan langkah-langkah yang belum dilakukan yang diperlukan untuk mengaktifkan platform. Misalnya, pelanggan lama mungkin sudah membagikan perangkat OEM kepada Google. Dalam hal ini, 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, penyelesaian penautan Cloud-to-cloud tidak boleh menjadi prasyarat untuk meminta izin Home API.

Saran desain visual

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

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

• Jika ada ruang, berikan penjelasan tentang apa yang akan terjadi saat pengguna berpindah dari satu layar ke layar lainnya.

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

Saran konten

Pengguna lebih mudah memercayai sesuatu yang mereka pahami dan memberikan nilai tambah. Mendukung pengguna dengan memberikan informasi untuk membuat keputusan yang tepat, termasuk pertimbangan.

Saran penting

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

• Perhatikan secara khusus cara Anda memposisikan penawaran.
• Buatlah judul yang menarik, tetapi jangan terlalu menjanjikan.
• Jika pengguna memerlukan perangkat yang disebutkan dalam saran Anda, pastikan hal tersebut dinyatakan dengan jelas agar mereka tidak menghadapi kendala yang tidak terduga.
• Anda mungkin hanya memiliki satu peluang untuk mendapatkan pengguna ini, jadi manfaatkan peluang tersebut.

Praktik terbaik

1. Mulailah dengan sudut pandang pengguna - pendekatan "apa manfaatnya bagi saya?".
2. Jangan menulis lebih dari empat baris konten dalam blok bagian. Kata-kata yang terlalu banyak dapat membuat pengguna tidak memperhatikan. Namun, kejelasan dan pemahaman bisa lebih penting daripada ringkas.
3. Otomatisasi itu menyenangkan! Pilih contoh yang menarik tetapi bermanfaat jika ruangnya memungkinkan.
4. Coba gunakan suara dan gaya bahasa yang menyenangkan jika sesuai dengan strategi Anda secara keseluruhan.
5. Gunakan frasa yang dapat ditindaklanjuti seperti "Mulai".