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 harus membagikan perangkat ke Google Home?
- Fase utama alur berbagi
- Penerapan teknis
- Praktik terbaik UX
Mengapa harus berbagi perangkat dengan Google Home?
Untuk menikmati kemampuan yang ditawarkan Home API, pengguna harus membagikan perangkat mereka ke Google Home karena:
- Ini adalah persyaratan teknis bagi Google untuk menggunakan perangkat ini dalam otomatisasi.
- Hal ini membantu mempertahankan pengalaman Google Home yang konsisten dan fleksibel.
- Memastikan bahwa perangkat ditampilkan secara konsisten di seluruh aplikasi yang mendukung Home API sangat penting untuk menghindari 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 | Meminta pengguna untuk memberikan izin ke aplikasi Anda. Sebelum menggunakan Home API, aplikasi Anda harus memiliki izin untuk mengakses perangkat di rumah pengguna (disebut sebagai struktur dalam API). Namun, urutan pelaksanaan langkah ini 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 hambatan bagi 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 | Pengaktifan Matter | Meskipun umumnya dianggap sebagai API untuk mengaktifkan perangkat Matter baru, Anda juga dapat menggunakan API ini untuk menambahkan fabric Google ke perangkat Matter 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 ke Google.
Untuk skenario berikut, sebaiknya ikuti langkah-langkahnya 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.
Panggil Permissions API di Android.
Panggil Commissioning API di Android di setiap perangkat Matter yang sebelumnya di-commission ke fabric lain.
- Karena berbagi Matter harus dilakukan untuk setiap
perangkat satu per satu, 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.
- 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.
- Karena berbagi Matter harus dilakukan untuk setiap
perangkat satu per satu, dan ada banyak layar yang memerlukan input pengguna,
sebaiknya Anda memandu pengguna melalui proses ini dengan:
Anda hanya memproduksi perangkat yang dibagikan ke Google menggunakan Cloud-to-cloud API
Lakukan deep linking Cloud-to-cloud. Tindakan ini akan menambahkan perangkat ke Google Home Graph.
- Sebaiknya lakukan penautan Cloud-to-cloud terlebih dahulu untuk menghindari situasi yang berpotensi membingungkan, seperti pengguna melihat daftar yang berisi perangkat yang dibagikan ke Google dan perangkat yang tidak dibagikan ke Google.
Panggil Permissions API di Android.
Anda memproduksi perangkat Cloud-to-cloud dan Matter
Lakukan deep linking Cloud-to-cloud.
- Sebaiknya lakukan penautan Cloud-to-cloud terlebih dahulu untuk menghindari situasi yang berpotensi membingungkan, seperti pengguna melihat daftar yang berisi perangkat yang dibagikan ke Google dan perangkat yang tidak dibagikan ke Google.
Panggil Permissions API di Android.
Panggil Commissioning API untuk Android di setiap perangkat Matter yang sebelumnya di-commission ke fabric lain.
- Karena berbagi Matter harus dilakukan untuk setiap
perangkat satu per satu, 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.
- 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.
- Karena berbagi Matter harus dilakukan untuk setiap
perangkat satu per satu, dan ada banyak layar yang memerlukan input pengguna,
sebaiknya Anda memandu pengguna melalui proses ini dengan:
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
Daftar ini tidak lengkap, dan Anda mungkin menemukan peluang lain untuk memberikan promosi dan pengalaman berbagi Google Home yang tepat waktu bagi pengguna Anda.
Keduanya juga tidak saling eksklusif, dan ada beberapa titik entri:
Dari menu Setelan
Karena pengguna mungkin terbiasa menyiapkan koneksi dengan ekosistem Google Home mereka melalui menu setelan, metode ini memungkinkan mereka untuk melanjutkan 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 mana 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 dengan cepat beralih ke alur izin.
Hanya dari commissioning
Skenario ini terutama ditujukan untuk partner yang hanya memproduksi perangkat Matter (bukan 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:
Secara umum, Anda harus meminta pengguna untuk hanya menyelesaikan langkah-langkah yang belum dilakukan yang diperlukan untuk melakukan aktivasi di platform. Misalnya, pelanggan lama mungkin sudah membagikan perangkat OEM kepada Google, sehingga mereka hanya perlu melalui proses pemberian izin Home API untuk memberi aplikasi akses ke Google Home mereka.
Beberapa administrator Google Home mungkin berbagi struktur rumah Google Home, dan dalam beberapa kasus, hanya satu akun yang mungkin 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 aktivasi ke Google Home (misalnya, "Buat otomatisasi lanjutan yang didukung oleh Google Home" atau "Kontrol perangkat menggunakan aplikasi pilihan Anda").
Pesan ajakan (misalnya, "Mulai") dan cara untuk membatalkan jika pengguna tidak ingin melanjutkan.
Jika ruang memungkinkan, penjelasan tentang apa yang akan terjadi saat pengguna melanjutkan proses di layar.
Khusus untuk Matter, jika pengguna sebelumnya telah memberi Anda akses ke rumahnya melalui Home API, Anda dapat memungkinkan perangkat di rumahnya dibagikan ke Google Home saat mengaktifkan perangkat baru. Misalnya, Anda dapat menambahkan perangkat Matter ke fabric Anda, lalu meminta pengguna untuk menambahkan perangkat ini ke fabric Google.
Saran konten
Pengguna akan lebih mudah memercayai sesuatu yang mereka pahami dan memberikan nilai tambah. Memberdayakan pengguna dengan memberikan informasi untuk membuat keputusan yang tepat, termasuk konsekuensinya.
Presentasi penting
Pengguna tidak akan melanjutkan proses berbagi perangkat jika tidak ada proposisi nilai yang kuat untuk melakukannya.
- Perhatikan dengan saksama cara Anda memosisikan penawaran.
- Buat judul yang menarik, tetapi jangan berlebihan.
- Jika pengguna memerlukan perangkat yang disebutkan dalam presentasi Anda, pastikan hal itu dinyatakan dengan jelas agar mereka tidak mengalami hambatan yang tidak terduga.
- Anda mungkin hanya memiliki satu peluang untuk menarik perhatian pengguna ini, jadi manfaatkan sebaik-baiknya.
Praktik terbaik
- Mulailah dengan sudut pandang pengguna, yaitu pendekatan "apa manfaatnya bagi saya?".
- Jangan menulis lebih dari empat baris konten dalam blok bagian. Kata-kata yang terlalu banyak dapat membuat pengguna kehilangan perhatian. Namun, kejelasan dan pemahaman bisa lebih penting daripada keringkasan.
- Otomatisasi itu menyenangkan. Pilih contoh yang menarik, tetapi bermanfaat jika ruang memungkinkan.
- Coba gunakan gaya bahasa dan nada yang ceria jika sesuai dengan strategi Anda secara keseluruhan.
- Gunakan frasa yang dapat ditindaklanjuti seperti "Mulai".