Bu kılavuzda, uygulamanızdaki ilk katılım deneyimi için sorunsuz Google Home API'leri cihaz izinleri ve paylaşımı tasarlamaya yönelik kullanıcı deneyimi rehberliği sunulmaktadır.
Burada açıklanan ana konular şunlardır:
- Cihazları neden Google Home ile paylaşmalısınız?
- Paylaşım akışının önemli aşamaları
- Teknik uygulama
- Kullanıcı deneyimiyle ilgili en iyi uygulamalar
Cihazları neden Google Home ile paylaşmalısınız?
Kullanıcılar, Home API'lerin sunduğu özelliklerden yararlanmak için cihazlarını Google Home ile paylaşmalıdır. Bunun nedeni:
- Google'ın bu cihazları otomasyonlarda kullanması teknik bir gerekliliktir.
- Bu sayede tutarlı ve esnek bir Google Home deneyimi sunulur.
- Cihazların, Home API'nin etkin olduğu uygulamalarda tutarlı bir şekilde sunulması, kullanıcıların temel görevleri yerine getirmek için uygulamalar arasında geçiş yapması gereken parçalı ve kafa karıştırıcı bir kullanıcı deneyimi oluşturmamak açısından çok önemlidir.
Paylaşım akışının temel bileşenleri
| Bileşen | Program | Açıklama |
|---|---|---|
| Android'deki Permissions API | Android'de izinler için Home API'leri | Kullanıcılardan uygulamanıza izin vermelerini ister. Home API'lerden herhangi birini kullanmadan önce uygulamanızın, kullanıcının evindeki cihazlara (API'de yapı olarak adlandırılır) erişim izni olmalıdır. Ancak bu adımın gerçekleştirilme sırası geliştirici senaryosuna bağlıdır ve Teknik uygulama bölümünde yer alır. |
| Buluttan buluta bağlantı | Hesap bağlama için buluttan buluta | Buluta bağlı cihazları uygulamanızdan Google Home ile paylaşmak için hesap bağlama işlemini başlatmanıza olanak tanır. Kullanıcıların zorluk yaşamasını önlemek için kullanıcıları doğrudan GHA'daki belirli hesap bağlama sayfanıza yönlendiren derin bağlantı özelliğini (hem Android hem de iOS'te kullanılabilir) kullanmanızı öneririz. |
| Android'de Commissioning API | Matter Devreye Alma | Genellikle yeni Matter cihazları devreye almak için kullanılan bir API olarak düşünülse de bu API'yi, başka bir yapıda devreye alınmış Mattercihazlara Google yapısını eklemek için de kullanabilirsiniz. Bu nedenle, oryantasyon sürecinde kullanışlı bir araçtır. |
Teknik uygulama
Paylaşım akışlarını nasıl oluşturacağınız, Google ile hangi cihazları paylaşmayı planladığınıza bağlıdır.
Aşağıdaki senaryolarda, adımları belirtilen sırayla uygulamanızı öneririz. Bu sayede kullanıcılara genel olarak daha iyi bir deneyim sunulur.
Yalnızca Matter cihazları üretiyorsanız
Google Home'da yetkilendirmek istediğiniz Matter özellikli cihazlar üretiyorsunuz.
Android'de Permissions API'yi çağırın.
Daha önce başka bir yapıya devreye alınmış her Matter cihazda Android'de Commissioning API'yi çağırın.
- Matter paylaşımı her cihaz için ayrı ayrı yapılmalıdır ve kullanıcı girişi gerektiren birçok ekran vardır. Bu nedenle, kullanıcıya bu süreçte aşağıdaki yöntemlerle rehberlik etmenizi öneririz:
- Kullanıcılara Google ile paylaşılmayan Matter cihazlarının listesini sunma
- Kullanıcıların, bu listedeki cihazları tıklayarak cihaz paylaşım sürecini (Commissioning API'yi kullanarak) başlatmasına izin verme.
- Matter cihazları listesine dönülerek görev ilerleme durumu ve paylaşım durumu kullanıcıya gösterilir.
- Matter paylaşımı her cihaz için ayrı ayrı yapılmalıdır ve kullanıcı girişi gerektiren birçok ekran vardır. Bu nedenle, kullanıcıya bu süreçte aşağıdaki yöntemlerle rehberlik etmenizi öneririz:
Yalnızca Cloud-to-Cloud API'leri kullanarak Google ile paylaşılan cihazlar üretiyorsunuz.
Cloud-to-cloudDerin bağlantı uygulayın. Bu işlem, cihazları Google Home Graph'e ekler.
- Kullanıcıya Google ile paylaşılan ve paylaşılmayan cihazların bir arada bulunduğu bir liste gösterilmesi gibi kafa karıştırıcı durumlardan kaçınmak için önce Cloud-to-cloud bağlantısı oluşturmanızı öneririz.
Android'de Permissions API'yi çağırın.
Hem buluttan buluta hem de Matter cihazlar üretiyorsanız
Cloud-to-cloudDerin bağlantı uygulayın.
- Kullanıcıya Google ile paylaşılan ve paylaşılmayan cihazların bir arada bulunduğu bir liste gösterilmesi gibi kafa karıştırıcı durumlardan kaçınmak için önce Cloud-to-cloud bağlantısı oluşturmanızı öneririz.
Android'de Permissions API'yi çağırın.
Daha önce başka bir yapıda devreye alınmış her Matter cihazda Android için Commissioning API'yi çağırın.
- Matter paylaşımı her cihaz için ayrı ayrı yapılmalıdır ve kullanıcı girişi gerektiren birçok ekran vardır. Bu nedenle, kullanıcıya bu süreçte aşağıdaki yöntemlerle rehberlik etmenizi öneririz:
- Kullanıcılara Google ile paylaşılmayan Matter cihazlarının listesini sunma
- Kullanıcıların, bu listedeki cihazları tıklayarak cihaz paylaşım sürecini (Commissioning API'yi kullanarak) başlatmasına izin verme.
- Matter cihazları listesine dönülerek görev ilerleme durumu ve paylaşım durumu kullanıcıya gösterilir.
- Matter paylaşımı her cihaz için ayrı ayrı yapılmalıdır ve kullanıcı girişi gerektiren birçok ekran vardır. Bu nedenle, kullanıcıya bu süreçte aşağıdaki yöntemlerle rehberlik etmenizi öneririz:
Google ile paylaşılacak cihazınız yok
Permissions API'yi çağırın.
Kullanıcı deneyimiyle ilgili en iyi uygulamalar
Bu bölümde, Home API'lerini kullanan bir uygulama geliştirirken dikkate alınması gereken bazı kritik kullanıcı yolculukları yer almaktadır.
Uygulamada cihaz paylaşımını tanıtma
Bu liste tam kapsamlı değildir. Kullanıcılarınıza zamanında Google Home tanıtımı ve paylaşım deneyimi sunmak için başka fırsatlar da bulabilirsiniz.
Bunlar birbirini dışlamaz ve birden fazla giriş noktası vardır:
Ayarlar menüsünden
Kullanıcılar muhtemelen Google Home ekosistemleriyle bağlantı kurmaya bir ayarlar menüsü aracılığıyla alıştıkları için bu yöntem, bu paradigmayı sürdürmelerine olanak tanır.
Cihaz paylaşımını (Cloud-to-cloud bağlantısı ve Matter Commissioning API) uygulama izinlerinden (Permissions API) ayırmak isteyebilirsiniz. Bu sayede kullanıcılar hangi adımları tamamlayacaklarını kontrol edebilir ve siz de bağlantı durumunu kullanıcıya gösterebilirsiniz.
Google tarafından çalıştırılan otomasyonlarda cihazları kullanırken
Kullanıcılar, Otomasyonlar sekmesinden paylaşım akışının giriş noktasına dokunabilir, ilerlemenin avantajlarını net bir şekilde açıklayan değer teklifi ekranını okuyabilir ve ardından izin akışında hızlıca ilerleyebilir.
Yalnızca devreye alma işleminden
Bu senaryo, öncelikle yalnızca Matter cihazları üreten (Cloud-to-cloud cihazı üretmeyen) ve kendi Matter yapısı olmayan iş ortakları için geçerlidir. Kullanıcının giriş noktası, Matter cihazlarının paylaşımının (Devreye Alma API'si aracılığıyla) ve uygulama izinlerinin (İzinler API'si aracılığıyla) aynı kullanıcı deneyimi akışının bir parçası olduğu, kutudan çıkar çıkmaz kullanılabilen bir ekrandan hemen sonra gelebilir.
Paylaşım mantığı
Kullanıcı istemleriyle ilgili bazı öneriler:
Genellikle kullanıcılardan yalnızca platforma katılmak için gereken eksik adımları tamamlamalarını istemeniz gerekir. Örneğin, uzun süredir müşteriniz olan kullanıcılar bir OEM'in cihazlarını Google ile paylaşıyor olabilir. Bu durumda, uygulamanın Google Home'larına erişmesine izin vermek için yalnızca Home API'leri izin verme sürecinden geçmeleri gerekir.
Birden fazla Google Home yöneticisi bir Google Home yapısını paylaşıyor olabilir ve bazı durumlarda cihazları Google ile paylaşmak için yalnızca bir hesap kullanılabilir. Bu nedenle, Home API'leri izinlerini istemek için Cloud-to-cloud bağlantısının tamamlanması ön koşul olmamalıdır.
Görsel tasarım önerileri
Google Home'a eklemenin net bir avantajı (örneğin, "Google Home tarafından desteklenen gelişmiş otomasyonlar oluşturun" veya "Seçtiğiniz uygulamaları kullanarak cihazları kontrol edin").
Harekete geçirici mesaj (ör. "Başlayın") ve kullanıcının devam etmek istememesi durumunda iptal etme seçeneği.
Yer varsa kullanıcı ekranlarda ilerledikçe ne olacağına dair bir açıklama.
Özellikle Matter için, kullanıcı daha önce Home API'leri aracılığıyla evinize erişim izni verdiğinde, yeni cihazları devreye alırken evindeki cihazları Google Home ile paylaşmayı mümkün kılabilirsiniz. Örneğin, yapınıza bir cihaz ekleyebilir ve ardından kullanıcıdan bu cihazı Google yapısına eklemesini isteyebilirsiniz.Matter
İçerik önerileri
Kullanıcıların anladıkları ve değer katan bir şeye güvenmeleri daha kolaydır. Ödün vermeyi de içeren bilinçli kararlar almaları için bilgi sağlayarak kullanıcıları destekleyin.
Kritik sunum
Güçlü bir değer teklifi yoksa kullanıcılar cihaz paylaşma yolunda ilerlemeye devam etmez.
- Teklifi nasıl konumlandırdığınıza özellikle dikkat edin.
- İlgi çekici bir başlık seçin ancak tutamayacağınız sözler vermeyin.
- Kullanıcının sunumunuzda bahsedilen bir cihaza ihtiyacı varsa beklenmedik bir engelle karşılaşmaması için bunu açıkça belirtin.
- Bu kullanıcıları yakalamak için yalnızca bir fırsatınız olabilir. Bu nedenle, bu fırsatı iyi değerlendirin.
En iyi uygulamalar
- Kullanıcının bakış açısıyla başlayın: "Bu özellik bana ne kazandıracak?" yaklaşımı.
- Bölüm bloklarına dörtten fazla satır içerik yazmayın. Daha fazla kelime kullanırsanız kullanıcının dikkatini kaybedebilirsiniz. Ancak netlik ve anlaşılırlık, kısa olmaktan daha önemli olabilir.
- Otomasyonlar eğlencelidir. Yer varsa heyecan verici ancak faydalı bir örnek seçin.
- Genel stratejinize uygunsa eğlenceli bir üslup ve ton kullanmayı deneyin.
- "Başlayın" gibi harekete geçirici ifadeler kullanın.