Bu kılavuz, 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 yönergeleri sağlar.
Burada açıklanan başlıca konular şunlardır:
- Cihazları neden Google Home ile paylaşmalıyım?
- Paylaşım akışının önemli aşamaları
- Teknik uygulama
- Kullanıcı deneyimiyle ilgili en iyi uygulamalar
Cihazları Google Home ile neden paylaşmalısınız?
Kullanıcıların Home API'lerinin sunduğu özelliklerden yararlanabilmesi için cihazlarını Google Home ile paylaşmaları gerekir. Bunun nedeni:
- Google'ın bu cihazları otomasyonlarda kullanması için teknik olarak gereklidir.
- Tutarlı ve esnek bir Google Home deneyimi sunar.
- Cihazların Home API'nin etkin olduğu uygulamalarda tutarlı bir şekilde gösterilmesi, kullanıcıların temel görevleri tamamlamak için uygulamalar arasında geçiş yapması gereken, parçalanmış ve kafa karıştırıcı bir kullanıcı deneyimi oluşturmamak için çok önemlidir.
Paylaşım akışının temel bileşenleri
| Bileşen | Program | Açıklama |
|---|---|---|
| Android'deki Permissions API'si | Android'de izinler için Home API'leri | Kullanıcılardan uygulamanıza izin vermelerini ister. Ev API'lerinden herhangi birini kullanmadan önce uygulamanızın, kullanıcının evindeki cihazlara (API'de yapı olarak adlandırılır) erişme 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ğlama | Hesap bağlama için buluttan buluta | Buluta bağlı cihazları Google Home ile paylaşmak için uygulama içinden hesap bağlama sürecini başlatmanıza olanak tanır. Kullanıcıların yaşadığı sorunları azaltmak 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'deki Commissioning API'si | Matter'ı kullanmaya başlama | Genellikle yeni Matter cihazları devreye almak için kullanılan bir API olarak düşünülse de bu API'yi, başka bir ağa daha önce devreye alınmış Matter cihazlara Google ağını eklemek için de kullanabilirsiniz. Bu nedenle, bu özellik, oryantasyon süreci için faydalı bir araçtır. |
Teknik uygulama
Paylaşım akışlarını nasıl oluşturacağınız, Google ile paylaşmayı planladığınız cihazlara bağlıdır.
Aşağıdaki senaryolarda adımları belirtilen sırayla uygulamanızı öneririz. Bu, kullanıcılara genel olarak daha iyi bir deneyim sunmaya yardımcı olur.
Yalnızca Matter cihazları üretiyorsanız
Google Home'da kullanıma almak istediğiniz Matter özellikli cihazlar üretiyorsunuz.
Android'deki İzinler API'sini çağırın.
Daha önce başka bir kumaş için devreye alınmış her Matter cihazda Android'de devreye alma API'sini çağırın.
- Matter paylaşımı her cihaz için ayrı ayrı yapılması gerektiğinden ve kullanıcı girişi gerektiren birçok ekran olduğundan, 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 gösterme.
- 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ülür, görev ilerleme durumu ve paylaşım durumu kullanıcıya gösterilir.
- Matter paylaşımı her cihaz için ayrı ayrı yapılması gerektiğinden ve kullanıcı girişi gerektiren birçok ekran olduğundan, 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 üretiyorsanız
Cloud-to-cloud Derin bağlantı gerçekleştirin. Bu işlem, cihazları Google Home Graph'e ekler.
- Kullanıcının Google ile paylaşılan ve Google ile paylaşılmayan cihazları içeren bir liste görmesi gibi kafa karıştırıcı durumları önlemek için önce Cloud-to-cloud bağlama işlemini yapmanızı öneririz.
Android'deki İzinler API'sini çağırın.
Hem buluttan buluta hem de Matter cihazları üretiyorsanız
Cloud-to-cloud Derin bağlantı gerçekleştirin.
- Kullanıcının Google ile paylaşılan ve Google ile paylaşılmayan cihazları içeren bir liste görmesi gibi kafa karıştırıcı durumları önlemek için önce Cloud-to-cloud bağlama işlemini yapmanızı öneririz.
Android'deki İzinler API'sini çağırın.
Daha önce başka bir kumaş için devreye alınmış her Matter cihazda Android için devreye alma API'sini çağırın.
- Matter paylaşımı her cihaz için ayrı ayrı yapılması gerektiğinden ve kullanıcı girişi gerektiren birçok ekran olduğundan, 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 gösterme.
- 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ülür, görev ilerleme durumu ve paylaşım durumu kullanıcıya gösterilir.
- Matter paylaşımı her cihaz için ayrı ayrı yapılması gerektiğinden ve kullanıcı girişi gerektiren birçok ekran olduğundan, kullanıcıya bu süreçte aşağıdaki yöntemlerle rehberlik etmenizi öneririz:
Google ile paylaşabileceğiniz cihazınız yoksa
İzinler API'sini çağırın.
Kullanıcı deneyimiyle ilgili en iyi uygulamalar
Bu bölümde, Home API'lerinden yararlanan bir uygulama geliştirirken dikkate alınması gereken bazı önemli kullanıcı yolculukları yer almaktadır.
Uygulamada cihaz paylaşımını nerede tanıtabilirsiniz?
Bu liste tam kapsamlı değildir ve kullanıcılarınıza zamanında Google Home tanıtımı yapıp paylaşım deneyimi sunmak için başka fırsatlar da bulabilirsiniz.
Bunlar da birbirini dışlamaz ve birden fazla giriş noktası vardır:
Ayarlar menüsünden
Kullanıcılar, Google Home ekosistemleriyle bağlantı kurmak için genellikle ayarlar menüsünü kullandığından bu yöntem, kullanıcıların bu alışkanlıklarını 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 bağlantı durumunu kullanıcıya gösterme fırsatı elde edebilirsiniz.
Google tarafından çalıştırılan otomasyonlarda cihaz kullanırken
Otomasyonlar sekmesinde, kullanıcılar paylaşım akışına bir giriş noktasına dokunabilir, ilerlemenin avantajlarını net bir şekilde açıklayan bir değer teklifi ekranını okuyabilir ve ardından izin akışında hızlıca ilerleyebilir.
Yalnızca komisyonlardan
Bu senaryo, öncelikle yalnızca Matter cihazları üreten (Cloud-to-cloud cihazları üretmeyen) ve kendi Cloud-to-cloud kumaşlarına sahip olmayan iş ortakları için geçerlidir.Matter Kullanıcı için giriş noktası, Matter cihazların paylaşımının (Commissioning API aracılığıyla) ve uygulama izinlerinin (Permissions API aracılığıyla) aynı kullanıcı deneyimi akışının parçası olduğu, kutudan çıkarma türü bir ekranın hemen ardından gelebilir.
Paylaşım mantığı
Kullanıcı istemleriyle ilgili bazı öneriler:
Genellikle kullanıcılardan yalnızca platforma katılım için gerekli olan eksik adımları tamamlamalarını istemelisiniz. Örneğin, uzun süredir müşteriniz olan kullanıcılar, OEM'nin cihazlarını Google ile paylaşıyor olabilir. Bu durumda, uygulamaya Google Home'larına erişim izni vermek için yalnızca Home API'leri izin verme sürecini tamamlamaları gerekir.
Birden fazla Google Home yöneticisi, 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, Cloud-to-cloud bağlantısının tamamlanması, Home API'leri izinleri için istemde bulunmak üzere ön koşul olmamalıdır.
Görsel tasarım önerileri
Google Home'a geçişin net bir avantajı (ör. "Google Home destekli gelişmiş otomasyonlar oluşturun" veya "Cihazları istediğiniz uygulamaları kullanarak kontrol edin").
Bir harekete geçirici mesaj (ör. "Başlayın") ve kullanıcının devam etmek istememesi durumunda iptal etme yolu.
Alan izin veriyorsa kullanıcının ekranlarda ilerledikçe neler olacağını açıklayın.
Özellikle Matter için, kullanıcı daha önce Home API'leri aracılığıyla evinize erişim izni verdiyse yeni cihazları devreye alırken evindeki cihazları Google Home ile paylaşmasını sağlayabilirsiniz. Örneğin, Matter kumaşınıza bir cihaz ekleyebilir ve ardından kullanıcıdan bu cihazı Google kumaşına eklemesini isteyebilirsiniz.
İçerik önerileri
Kullanıcılar, anladıkları ve değer katan şeylere daha kolay güvenir. Kullanıcılara, ödünler de dahil olmak üzere bilinçli kararlar vermelerini sağlayacak bilgiler sunarak destek olun.
Kritik şarkı önerisi
Kullanıcılar, cihaz paylaşımı için güçlü bir değer önerisi yoksa bu yolu izlemeye devam etmez.
- Teklifi nasıl konumlandırdığınıza özellikle dikkat edin.
- İlgi çekici bir açıklama yazın ancak abartılı vaatlerde bulunmayın.
- Kullanıcının şarkı önerinizde bahsedilen bir cihaza ihtiyacı varsa bunu açıkça belirtin. Böylece kullanıcılar beklenmedik bir engelle karşılaşmaz.
- Bu kullanıcıları kazanmak 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: "Bunun bana ne faydası var?" yaklaşımı.
- Bir bölüm bloğunda dört satırdan fazla içerik yazmayın. Daha fazla kelime kullanıcının dikkatini dağıtabilir. Ancak netlik ve anlaşılırlık, kısa olmaktan daha önemli olabilir.
- Otomasyonlar eğlencelidir. Alan izin veriyorsa ilgi çekici ancak faydalı bir örnek seçin.
- Genel stratejinizle uyumluysa eğlenceli bir dil ve üslup kullanmayı deneyin.
- "Başlayın" gibi harekete geçirici ifadeler kullanın.