Android'de kullanıcı deneyimi kullanmaya başlama

Commissioning API'yi kullanan uygulamanızdaki devreye alma akışı iki şekilde başlatılabilir: doğrudan uygulamanızda veya Hızlı Eşleme işlemindeki bir uygulama seçici aracılığıyla. Bu bölümde, her birinin kullanıcı deneyimi (UX) ele alınmaktadır.

Uygulama tarafından başlatıldı

Bu senaryoda kullanıcı, genellikle "Cihaz Ekle" harekete geçirici mesajından (CTA) başlayarak uygulamanızda cihaz etkinleştirmeye başlar. Cihaz Ekle düğmesini aşağıdaki gibi göstermenizi öneririz:

  • Kullanıcıların tüm cihazlarını gördüğü bir Denetimler sayfası gibi
  • Kullanıcıların evi yönetebileceği bir yer (ör. Ayarlar sayfası)
  • Uygulamanızın Ana Sayfa'sı

Devreye alma işlemi tamamlandığında kullanıcıyı uygulamanın Ana Sayfası'na veya uygulamada kullanıcıya yeni kurduğu cihaz denetleyiciyi ya da yeni kurulan cihaz da dahil olmak üzere tüm cihazların tam listesini gösteren bir konuma yönlendirmenizi öneririz.

Kullanıcı deneyimi Şekil 2'de gösterilmiştir:

  • Uygulama Tarafından Başlatılan Etkinleştirme (1. Adım)

    Uygulamanın kullanıcısı Cihaz ekle'yi tıklar.

  • Uygulama Tarafından Başlatılan Devreye Alma (2. Adım)

    Kullanıcı, QR kodunu tarar veya eşleme kodunu girer.

  • Uygulama Tarafından Başlatılan Devreye Alma (3. Adım)

    Kullanıcıdan cihazı Google ağına eklemeyi kabul etmesi (bu, Şekil 1'deki "İzin + Meta Veriler"e karşılık gelir) ve kullanılacak Google Hesabı'nı seçmesi istenir.

  • Uygulama Tarafından Başlatılan Etkinleştirme (4. Adım)

    Kullanıcının birden fazla evi varsa bir ev seçmesi istenir. Kullanıcının Home uygulamasında ayarlanmış bir evi yoksa otomatik olarak "Home" adlı bir ev oluşturulur.

  • Uygulama Tarafından Başlatılan Etkinleştirme (5. Adım)

    Commissioning API cihaza bağlanır.

  • Uygulama Tarafından Başlatılan Etkinleştirme (6. Adım)

    Kullanıcıdan cihazın bulunduğu odayı seçmesi istenir.

  • Uygulama Tarafından Başlatılan Devreye Alma (8. Adım)

    Kullanıcıdan cihazı yeniden adlandırması istenir.

  • Uygulama Tarafından Başlatılan Etkinleştirme (10. Adım)

    Commissioning API, Matter kimlik bilgilerini oluşturur, ağ bağlantısını kontrol eder ve ardından cihazı seçili ağa bağlayarak devreye alma işlemini yürütür.

  • Uygulama Tarafından Başlatılan Etkinleştirme (11. Adım)

    Kullanıcının yapısı ve cihazları için izin verilmişse cihaz, ilgili evdeki diğer cihazlarla birlikte Home'da görünür ve uygulama kullanılarak kontrol edilebilir.

    Kullanıcının yapısı ve cihazları için henüz izin verilmediyse cihaz henüz uygulamada görünmez veya kontrol edilemez. Bir uygulamada cihaza erişmek ve cihazı kontrol etmek için izin gerekir.

Şekil 2: Uygulama tarafından başlatılan yetkilendirme

Hızlı Eşleme tarafından başlatıldı

Devreye alma işlemi, Android'de Hızlı Eşleme kullanılarak da başlatılabilir. Cihazın Matter QR kodunu taradıktan sonra kullanıcıdan, devreye alma işlemine devam etmek için bir uygulama seçmesi istenir. Uygulamanızı seçtiğinizde, Şekil 3'te gösterildiği gibi uygulamadan Commissioning API kullanılır.

Kullanıcının mobil cihazında uygulama yüklü değilse devam etmeden önce uygulamayı yüklemesi istenir. Kullanıcı deneyimi, izin ekranından itibaren Şekil 2'dekiyle aynıdır.

  • Hızlı Eşleme Kurulumu (1. Adım)

    Kullanıcıdan QR kodu taraması istenir.

  • Hızlı Eşleme Kurulumu (2. Adım)

    Kullanıcı, cihazın Matter QR kodunu tarar.

  • Hızlı Eşleme Kurulumu (3. Adım)

    Kullanıcıdan, devreye alma işlemine devam etmek için bir uygulama seçmesi istenir.

  • Hızlı Eşleme Kurulumu (4. Adım)

    Uygulama yüklü değilse kullanıcıdan uygulamayı yüklemesi istenir.

  • Hızlı Eşleme Kurulumu (5. Adım)

    Uygulama, Google Play Store'dan indirilir.

  • Hızlı Eşleme Kurulumu (6. Adım)

    Uygulama yüklü.

  • Hızlı Eşleme Kurulumu (7. Adım)

    Uygulama başarıyla yüklendikten sonra kullanıcıdan devam etmesi istenir.

  • Hızlı Eşleme Kurulumu (8. Adım)

    Kullanıcıdan cihazı Google ağına eklemeyi kabul etmesi (bu, Şekil 1'deki "İzin + Meta Veriler"e karşılık gelir) ve kullanılacak Google Hesabı'nı seçmesi istenir.

  • Hızlı Eşleme Kurulumu (9. Adım)

    Kullanıcının birden fazla evi varsa bir ev seçmesi istenir. Kullanıcının Home uygulamasında ayarlanmış bir evi yoksa otomatik olarak "Home" adlı bir ev oluşturulur.

  • Hızlı Eşleme Kurulumu (10. Adım)

    Commissioning API cihaza bağlanır.

  • Hızlı Eşleme Kurulumu (11. Adım)

    Kullanıcıdan cihazın bulunduğu odayı seçmesi istenir.

  • Hızlı Eşleme Kurulumu (13. Adım)

    Kullanıcıdan cihazı yeniden adlandırması istenir.

  • Hızlı Eşleme Kurulumu (15. Adım)

    Commissioning API, Matter kimlik bilgilerini oluşturur, ağ bağlantısını kontrol eder ve ardından cihazı seçilen kumaşa bağlayarak devreye alma işlemini yürütür.

  • Hızlı Eşleme Devreye Alma (16. Adım)

    Kullanıcının yapısı ve cihazları için izin verilmişse cihaz, ilgili evdeki diğer cihazlarla birlikte Home'da görünür ve uygulama kullanılarak kontrol edilebilir.

    Kullanıcının yapısı ve cihazları için henüz izin verilmediyse cihaz henüz uygulamada görünmez veya kontrol edilemez. Bir uygulamada cihaza erişmek ve cihazı kontrol etmek için izin gerekir.

Şekil 3: Hızlı Eşleme Etkinleştirme

Uygulama seçici

Seçebileceğiniz iki uygulamayı gösteren uygulama seçicinin görünümü

Uygulamanızın, devreye alma işlemi sırasında uygulama seçicide görünmesinin iki yolu vardır:

  1. Uygulama seçin ekranında.
  2. Kullanıcılar Başka uygulama seç'i belirlerse bu uygulama Yüklü Diğer Uygulamalar ekranında gösterilir.

Önerilen Uygulamalar

Uygulama seçicide iki önerilen uygulama gösterilir.

  • İlki her zaman Google Home app (GHA).
  • İkincisi, cihaz üreticisinin tercih ettiği uygulama içindir (cihazın VID veya PID ile ilişkili bir Google Home Developer Console projesinde tanımlanmışsa). (Bu seçenek, Matter cihazları oluşturmayan uygulama geliştiriciler için geçerli değildir.) Cihaz üreticisi tarafından tercih edilen komisyoncu uygulaması

Uygulamalar Uygulama seçin ekranındayken iki senaryo vardır.

  1. Yüklü: Google Play services Uygulamanın ACTION_COMMISSION_DEVICE intent filtresini desteklediğinden emin olun. Intent filtresi eksikse kullanıcı, uygulamayı güncellemek için Play Store'a yönlendirilir.
  2. Yüklü değil: Kullanıcı, devam etmeden önce uygulamayı yüklemek için Play Store'a yönlendirilir.