Panduan ini memberikan panduan UX untuk mendesain izin perangkat Google Home API yang lancar dan berbagi untuk pengalaman orientasi di aplikasi Anda.
Topik utama yang dijelaskan di sini adalah:
- Mengapa berbagi perangkat dengan Google Home?
- Fase utama alur berbagi
- Implementasi teknis
- Praktik terbaik UX
Mengapa berbagi perangkat dengan Google Home?
Untuk menikmati kemampuan yang ditawarkan Home API, pengguna harus membagikan perangkat mereka dengan Google Home karena:
- Ini adalah persyaratan teknis bagi Google untuk menggunakan perangkat ini dalam otomatisasi.
- Hal ini membantu menjaga pengalaman Google Home yang konsisten dan fleksibel.
- Memastikan perangkat ditampilkan secara konsisten di seluruh aplikasi yang mengaktifkan Home API sangat penting untuk menghindari pengalaman pengguna yang terfragmentasi dan membingungkan saat pengguna harus beralih antar-aplikasi untuk menyelesaikan tugas dasar.
Komponen utama alur berbagi
| Komponen | Program | Deskripsi |
|---|---|---|
| Permissions API | Home API untuk Izin | Meminta 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-to-cloud untuk penautan akun | Memungkinkan Anda memulai proses penautan akun untuk berbagi perangkat yang terhubung ke cloud dengan Google Home dari dalam aplikasi. 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 | Komisi 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-langkah dalam urutan yang diberikan. Hal ini membantu memberikan pengalaman keseluruhan yang lebih baik bagi pengguna.
Anda hanya memproduksi perangkat Matter
Anda memproduksi perangkat yang kompatibel dengan Matter yang ingin Anda komisikan ke Google Home.
Panggil Permissions API.
Panggil Google Commissioning API di setiap perangkat Matter yang sebelumnya dikomisiasikan 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:
- Memberikan daftar perangkat Matter kepada pengguna 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 membagikan status 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 diberi daftar yang berisi perangkat yang dibagikan dengan Google dan perangkat yang tidak dibagikan dengan Google.
Panggil Permissions API.
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 diberi daftar yang berisi perangkat yang dibagikan dengan Google dan perangkat yang tidak dibagikan dengan Google.
Panggil Permissions API.
Panggil Google Commissioning API di setiap perangkat Matter yang sebelumnya dikomisiasikan 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:
- Memberikan daftar perangkat Matter kepada pengguna 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 membagikan status 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 berbagi perangkat di aplikasi
Daftar ini tidak lengkap, dan Anda mungkin menemukan peluang lain untuk memberikan presentasi Google Home yang tepat waktu dan pengalaman berbagi untuk pengguna.
Hal ini juga tidak saling terpisah, dan ada beberapa titik entri:
Dari menu Setelan
Karena pengguna mungkin terbiasa menyiapkan koneksi dengan ekosistem Google Home melalui menu setelan, metode ini memungkinkan mereka untuk melanjutkan paradigma ini.
Sebaiknya pisahkan berbagi perangkat (penautan Cloud-to-cloud dan Matter Commissioning API) dari izin aplikasi (Permissions API). Hal ini memberi pengguna kemampuan untuk mengontrol langkah mana yang mereka selesaikan, dan memberikan peluang bagi Anda 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 melanjutkan alur izin.
Hanya dari commissioning
Skenario ini terutama ditujukan untuk partner yang hanya memproduksi perangkat Matter (tidak ada perangkat Cloud-to-cloud) dan tidak memiliki fabric Matter sendiri. Titik entri untuk pengguna dapat muncul tepat setelah layar jenis siap pakai tempat berbagi perangkat Matter (melalui Commissioning API) dan izin aplikasi (melalui Permissions API) adalah bagian dari alur pengalaman pengguna yang sama.
Logika berbagi
Beberapa saran tentang perintah pengguna adalah:
Anda biasanya harus meminta pengguna untuk hanya menyelesaikan langkah-langkah yang belum dilakukan untuk melakukan aktivasi platform. Misalnya, pelanggan lama mungkin sudah berbagi perangkat OEM dengan Google. Dalam hal ini, mereka hanya perlu melakukan proses pemberian izin Home API untuk memberi aplikasi akses ke Google Home mereka.
Beberapa administrator Google Home mungkin berbagi struktur Google Home, dan dalam beberapa kasus, hanya satu akun yang mungkin digunakan untuk berbagi perangkat dengan Google. Akibatnya, 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 membatalkan jika pengguna tidak ingin melanjutkan.
Jika ruang memungkinkan, penjelasan tentang hal yang akan terjadi saat pengguna melanjutkan layar.
Khusus untuk Matter, jika pengguna sebelumnya telah memberikan akses ke rumah mereka melalui Home API, Anda dapat memungkinkan berbagi perangkat di rumah mereka dengan Google Home saat menyiapkan perangkat baru. Misalnya, Anda dapat menambahkan perangkat Matter ke fabric, 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. Dukung pengguna dengan memberikan informasi untuk membuat keputusan yang tepat, termasuk kompromi.
Pitch kritis
Pengguna tidak akan melanjutkan ke jalur berbagi perangkat jika tidak ada proposisi nilai yang kuat untuk melakukannya.
- Perhatikan dengan cermat cara Anda memosisikan penawaran.
- Buatlah menarik, tetapi jangan terlalu banyak mengumbar janji.
- Jika pengguna memerlukan perangkat yang disebutkan dalam presentasi Anda, pastikan hal tersebut dinyatakan dengan jelas sehingga mereka tidak mengalami hambatan yang tidak terduga.
- Anda mungkin hanya memiliki satu kesempatan untuk mendapatkan pengguna ini, jadi manfaatkan sebaik mungkin.
Praktik terbaik
- Mulailah dengan sudut pandang pengguna - pendekatan "apa manfaatnya bagi saya?".
- Jangan menulis lebih dari empat baris konten dalam blok bagian. Lebih banyak kata dapat membuat pengguna kehilangan perhatian. Namun, kejelasan dan pemahaman dapat lebih penting daripada keringkasan.
- Otomatisasi itu menyenangkan. Pilih contoh yang menarik tetapi bermanfaat jika ruangnya memungkinkan.
- Coba gunakan suara dan nada yang ceria jika sesuai dengan strategi Anda secara keseluruhan.
- Gunakan frasa yang dapat ditindaklanjuti seperti "Mulai".