Home APIs 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, 2024.2.1 ("Ladybug") sürümü veya sonraki sürümler. Bundan önceki sürümlerin Home APIs SDK'sıyla düzgün çalışmayabileceğini unutmayın.

    Android Studio'yu indirin

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

    adb'ı yükleyin.

    Bu işlem SDK Yöneticisi ile yapılabilir.

Home API'lerini test etmek için şunlar gerekir:

  • Geliştirme için kullanacağınız bir Google Hesabı ile ayarlanmış, Android 10 veya sonraki bir sürümü çalıştıran Android cihaz. Android Studio'ın güncel bir sürümünün yüklü olduğundan ve bu geliştirme hesabıyla oturum açtığınızdan emin olun.
  • Kablosuz ağ.
  • Home API'leri destekleyen bir Google merkezi.

  • Evde desteklenen en az bir cihaz Bu cihaz (veya test etmek istediğiniz başka bir cihaz) Thread kullanıyorsa hub da Thread sınır yönlendirici olmalıdır. Android örnek uygulaması aşağıdaki cihaz türlerini ve özelliklerini destekler:

    • Renk Sıcaklığı Işığı (açma/kapatma, parlaklık)
    • Temas Sensörü (boole durumu)
    • Kısılabilir ışık (açma/kapatma, parlaklık)
    • Genişletilmiş Renk Işığı (açma/kapatma, parlaklık)
    • Genel Anahtar
    • Doluluk Sensörü (doluluk algılama)
    • Işığı Açma/Kapatma (açma ve kapama, parlaklık)
    • Açma/Kapatma düğmeli ışık anahtarı
    • Açma/kapatma priz birimi (açık ve kapalı)
    • Açma/Kapatma Sensörü

  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 izin ekranınızı henüz yapılandırmadıysanız İzin ekranını yapılandır düğmesi görünür. Bu durumda, izin ekranınızı aşağıdaki prosedürü kullanarak yapılandırın. Aksi takdirde bir sonraki bölüme geçin.

    1. İzin 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 ardından 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örüntülenir.
    4. Herhangi bir kapsam eklemeniz gerekmez. Kaydet ve devam et'i tıklayın. Test kullanıcıları bölmesi gösterilir.
    5. Uygulamanıza erişimi test etmek için kullanıcı eklemek istiyorsanız Kullanıcı ekle'yi tıklayın. Kullanıcı ekle bölmesi gösterilir. Test kullanıcıları, uygulamanızda izin verme ayrıcalığına sahiptir.
    6. Boş alana bir veya daha fazla Google Hesabı e-posta adresi ekleyin ve ardından Ekle'yi 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 ardından Kontrol paneline dön'ü tıklayın.

Ayrıntılı bilgi için Google Cloud Console Yardım sitesindeki OAuth kullanıcı rızası ekranınızı ayarlama başlıklı makaleyi inceleyin.

Kaynak kodunu indirme

Örnek uygulamanın kaynak kodunu GitHub'da bulabilirsiniz.

Projeyi kaydetmek istediğiniz yere gidin ve ardından 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 tarafından geliştirme için sağlanan standart kitaplıkların bir parçası değildir. Home API'lerini kullanarak Android uygulamaları geliştirmek için kitaplıkları yerel olarak indirip barındırmanız gerekir.

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

Hemen oturum açın!

Derleme ve çalıştırma

  1. Android Studio'ü, ardından yerel makinenize klonlanan google-home-api-sample-app-android proje klasörünü açın.
  2. İlk kurulumunuz sırasında Android Studio'ün tüm proje bağımlılıkları indirmesi ve Gradle derlemesini tamamlaması 10 dakika kadar sürebilir.
    • Bu adımda Gradle Sync Failed gibi bir hata alırsanız senkronizasyonu tekrar başlatmak için Yeniden Dene'yi tıklayın.
  3. Ö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 bölümünü (yani com.example) seçin.
    4. Paketi sağ tıklayın ve Yeniden Düzenle > Yeniden adlandır...'ı seçin.
    5. Tüm Dizinler'i tıklayın.
    6. Yeni adı girin ve Yeniden yapılandır'ı tıklayın.
    7. build.gradle.kts dosyasını düzenleyin. android namespace ve applicationId değerlerini yeni paket adıyla değiştirin.
    8. AndroidManifest.xml dosyasını düzenleyin ve paketin dosyadaki her yerde yeni paket adıyla değiştirilmesini sağlayın.

  4. Uygulamayı Android Studio'te çalıştırarak hata ayıklama uygulaması imzalama sertifikası oluşturun. Android Studio'te bir uygulamayı çalıştırdığınızda veya uygulamada hata ayıkladığınızda Android Studio, geliştirme ve hata ayıklama için tasarlanmış bir uygulama imzalama sertifikası 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çip Projeyi çalıştır'ı tıklayın. Bu işlem, örnek uygulamayı oluşturup mobil cihazınıza yükler.

    Daha ayrıntılı talimatlar için Android Developers sitesinde Donanım cihazında uygulama çalıştırma başlıklı makaleyi inceleyin.

    Ardından, çalışan uygulamayı durdurun.

  5. Google Cloud Console Yardım sitesindeki OAuth 2.0'u ayarlama / 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.

  6. Örnek uygulamayı OAuth 2.0 için kaydedin ve OAuth 2.0 kurulumu bölümündeki talimatları uygulayarak OAuth kimlik bilgileri oluşturun.

    1. Uygulama türünü belirtin. Bu, yerel/Android uygulamasıdır.
    2. Google Cloud Console Yardım sitesindeki OAuth 2.0'u ayarlama / Yerel uygulamalar / Android bölümündeki talimatları uygulayarak SHA-1 parmak izini OAuth istemciye ekleyin. Geliştirme süreci boyunca varsayılan Android Studio anahtarından SHA-1 anahtarını oluşturmanız gerekir.
    3. Test kullanıcıları ekleyin. Test kullanıcıları, örnek uygulamada izin verme ayrıcalığına sahiptir.

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

Yüklenen uygulama, mobil cihazınızda Home API Örnek Uygulaması olarak kullanılabilir.