Home API'leri Android Örnek Uygulaması

Örnek uygulama, Android için Google Home API'lerinin temel özelliklerini gösterir.

Ön koşullar

Uygulamayı oluşturmak, yüklemek ve test etmek için birkaç ön koşulu karşılamanız gerekir:

  • Android Studio, sürüm 2024.2.1 ("Ladybug") veya sonraki sürümler. Bu sürümden önceki sürümlerin Home API'leri SDK'sı ile düzgün çalışmayabileceğini unutmayın.

    Android Studio'yu indirin

  • Android hata ayıklayıcı (adb).

    Yükle adb.

    Bu işlem SDK Manager ile yapılabilir.

Ayrıca Home API'lerini test etmek için şunlara ihtiyacınız olacak:

  • Geliştirme için kullanmak istediğiniz Google Hesabı ile ayarlanmış, Android 10 veya sonraki sürümleri çalıştıran bir Android cihaz. Android Studio uygulamasının güncel bir sürümünün yüklü olduğundan ve bu geliştirme hesabıyla oturum açıldığından emin olun.
  • Kablosuz ağ
  • Matter cihazlarına erişmek ve bunları kontrol etmek için Home API'leri destekleyen bir Google hub'ına da ihtiyacınız vardır. Ayrıntılar için Android'de bağlantı başlıklı makaleyi inceleyin.

  • Evde en az bir desteklenen cihaz olmalıdır. Bu cihaz (veya test etmek istediğiniz başka bir cihaz) Thread kullanıyorsa hub da Thread Border Router (TBR) olmalıdır. Aşağıdaki cihaz türleri ve özellikleri Android örnek uygulaması tarafından desteklenir:

    • Renk sıcaklığı ışığı (açma, kapama, parlaklık)
    • Temas Sensörü (boole durumu)
    • Kısılabilir Işık (açma/kapama, parlaklık)
    • Kapı Kilidi
    • Genişletilmiş Renkli Işık (açma/kapama, parlaklık)
    • Genel Anahtar
    • Google Border Router
    • Google Kamera
    • Google Doorbell
    • Doluluk Sensörü (doluluk algılama)
    • Açma/Kapama Işığı (açma ve kapama, parlaklık)
    • Açma/Kapatma Işık Anahtarı
    • Açma/Kapatma Fişli Birimi (açık ve kapalı)
    • Açma/Kapama Sensörü

Kaynak kodunu indirme

Örnek uygulamanın kaynak kodu GitHub'da mevcuttur.

Projeyi kaydetmek istediğiniz yere gidin ve projeyi klonlayın:

git clone https://github.com/google-home/google-home-api-sample-app-android.git

SDK'yı ayarlama

Bu açık beta sürümündeki Android için Home API'leri henüz Google'ın geliştirme için sağladığı standart kitaplıkların bir parçası değildir. Home API'leri ile Android uygulamaları geliştirmek için kitaplıkları indirip yerel olarak barındırmanız gerekir.

Home API'leri Android SDK'sını indirmek için öncelikle Google Home Developers'da oturum açmanız gerekir.

Hemen oturum açın!

Uygulamayı oluşturma

  1. Android Studio uygulamasını açın, ardından yerel makinenize kopyalanan google-home-api-sample-app-android proje klasörünü açın.

  2. İlk kurulum sırasında, Android Studio tüm proje bağımlılıklarını indirmek ve Gradle derlemesini tamamlamak için 10 dakika kadar sürebilir.

  3. Bilgisayarınızı USB kablosuyla fiziksel bir Android telefona bağlayın ve Geliştirici seçenekleri'nde ADB'yi etkinleştirin. Android Studio uygulamasının ADB üzerinden Android telefona bağlanabildiğinden emin olun.

  4. Örnek uygulamanın paket adını, daha önce kaydedilmemiş yeni bir adla (ör. kuruluşunuzun adına dayalı bir ad) değiştirin:

    1. Projeyi açın.
    2. Kaynak hiyerarşisini genişletin.
    3. Paketin değiştirmek istediğiniz kısmını seçin. Diğer bir deyişle, com.example.
    4. Paketi sağ tıklayın ve Refactor (Yeniden düzenle) > Rename...'i (Yeniden adlandır...) seçin. Yeniden düzenleme > Yeniden adlandırma menüsü
    5. Yeni adı girin ve Refactor'u (Yeniden düzenle) tıklayın.
    6. build.gradle.kts dosyasını düzenleyerek android namespace ve applicationId değerlerini yeni paket adıyla değiştirin.

  5. HomeModule.kt uygulamasında OAuth kapsamını yapılandırın. Örnek Uygulama kaynak kodu varsayılan olarak https://www.googleapis.com/auth/home.platform.v2 kapsamını kullanır. Örnek uygulamadaki birçok özellik home.platform.v2 kapsamıyla sınırlıdır ve erişim için iş ortağı onayı gerekir. Örnek uygulamayı standart https://www.googleapis.com/auth/home.platform.selected.devices kapsamıyla çalıştırmak için HomeModule.kt dosyasını açın ve HomeConfig içindeki homePlatformScope değerini HOME_PLATFORM_SCOPE_VERSION_1 olarak değiştirin:

    val homeConfig = HomeConfig(
  coroutineContext = Dispatchers.IO,
  factoryRegistryProvider = {
    FactoryConstants.factoryRegistryAllTraitsAllTypes
  },
  homePlatformScope =
    HomeConfig.HomePlatformScope.HOME_PLATFORM_SCOPE_VERSION_1
)

HomeClientProvider.kt içindeki switchAccount() adlı grupta homePlatformScope adlı kullanıcının rolünü HOME_PLATFORM_SCOPE_VERSION_1 olarak güncelleyin. Aksi takdirde, hesap değiştirmek için profil simgesini seçtiğinizde uygulama HOME_PLATFORM_SCOPE_VERSION_2 sürümüne geri döner.

  1. Gerekli tüm kitaplıklar indirilip Gradle senkronizasyonu tamamlandıktan sonra Run (Çalıştır) düğmesini tıklayarak uygulamayı derleyip çalıştırın. Uygulama telefonunuzda başarıyla çalıştırıldığında Sample App (Örnek Uygulama) ana sayfasını görürsünüz.

İmzalama sertifikası oluşturma

Android Studio uygulamasında bir uygulamayı çalıştırdığınızda veya hata ayıklama yaptığınızda, geliştirme ve hata ayıklama için otomatik olarak bir hata ayıklama sertifikası oluşturulur. Ayrıntılı açıklama için Android Studio: Hata ayıklama derlemenizi imzalama başlıklı makaleyi inceleyin.

  1. Uygulamayı Android Studio içinde çalıştırarak hata ayıklama uygulaması imzalama sertifikası oluşturun. Android Studio uygulamasında bir uygulamayı çalıştırdığınızda veya uygulamanın hatalarını ayıkladığınızda Android Studio, geliştirme ve hata ayıklama için tasarlanmış bir uygulama imzalama sertifikasını otomatik olarak oluşturur. Ayrıntılı açıklama için Android Studio: Hata ayıklama derlemenizi imzalama başlıklı makaleyi inceleyin.

    Mobil cihazınızı yerel makinenize bağlayın. Android Studio, bağlı cihazlarınızı model numarasına göre listeler. Listeden cihazınızı seçin ve Run project'i (Projeyi çalıştır) tıklayın. Bu işlem, örnek uygulamayı derleyip mobil cihazınıza yükler.

    Daha ayrıntılı talimatlar için Android Developers sitesindeki Uygulamaları donanım cihazında çalıştırma başlıklı makaleyi inceleyin.

    Şimdi çalışan uygulamayı durdurun.

  2. Google Cloud Console Yardım sitesindeki OAuth İstemcilerini Yönetme / Uygulama Türleri / Yerel uygulamalar / Android bölümünde ayrıntılı olarak açıklanan talimatları uygulayarak hata ayıklama sertifikanızın SHA-1 parmak izini alın.

  1. Google Cloud Console'da proje seçici kontrol paneline gidin ve OAuth kimlik bilgileri oluşturmak için kullanmak istediğiniz projeyi seçin.
  2. API'ler ve Hizmetler sayfasına gidin ve gezinme menüsünde Kimlik Bilgileri'ni tıklayın.

  3. Bu Google Cloud projesi için kullanıcı rızası ekranınızı henüz yapılandırmadıysanız Configure consent screen (Kullanıcı rızası ekranını yapılandır) düğmesi görünür. Bu durumda, kullanıcı rızası ekranınızı aşağıdaki prosedürü kullanarak yapılandırın. Aksi takdirde bir sonraki bölüme geçin.

    1. Kullanıcı rızası ekranını yapılandır'ı tıklayın. OAuth kullanıcı rızası ekranı sayfası gösterilir.
    2. Kullanım alanınıza bağlı olarak Dahili veya Harici'yi seçin ve Oluştur'u tıklayın. OAuth kullanıcı rızası ekranı bölmesi gösterilir.
    3. Uygulama bilgileri sayfasında ekrandaki talimatlara göre bilgileri girin ve Kaydet ve devam et'i tıklayın. Kapsamlar bölmesi gösterilir.
    4. Herhangi bir kapsam eklemeniz gerekmediğinden Kaydet ve devam et'i tıklayın. Test kullanıcıları bölmesi gösterilir.
    5. Kitle'yi ve + KULLANICI EKLE düğmesini tıklayın.
    6. Test kullanıcısı e-posta adresinizi girin ve KAYDET düğmesini tıklayın.
    7. Kaydet ve devam et'i tıklayın. Özet bölmesi gösterilir.
    8. OAuth kullanıcı rızası ekranı bilgilerinizi inceleyin ve Kontrol paneline geri dön'ü tıklayın.

Tüm ayrıntılar için Google Cloud Console Yardım sitesindeki OAuth kullanıcı rızası ekranınızı ayarlama başlıklı makaleyi inceleyin. Devam etmeden önce en az bir test kullanıcısı eklediğinizden emin olun.

OAuth kimlik bilgilerini ayarlama

  1. OAuth 2.0'ı ayarlama bölümündeki talimatları uygulayarak örnek uygulamayı OAuth 2.0 için kaydedin ve OAuth kimlik bilgileri oluşturun.
    1. Uygulama türünü yerel/Android uygulaması olarak belirtin.
    2. Google Cloud Console Yardım sitesindeki OAuth 2.0 / Yerel uygulamalar / Android'i ayarlama başlıklı makalede verilen talimatları uygulayarak SHA-1 parmak izini OAuth istemcisine ekleyin. Geliştirme süreci boyunca varsayılan Android Studio anahtarından SHA-1 anahtarı oluşturmanız gerekir.

Uygulamayı çalıştırma

  1. Mobil cihazınız yerel makinenize bağlıyken mobil cihazınızda örnek uygulamayı çalıştırmak için tekrar Projeyi çalıştır'ı tıklayın.

Yüklendikten sonra uygulama, mobil cihazınızda Home API Sample App olarak kullanılabilir.