Home APIs Android örnek uygulaması

Örnek uygulama, 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 ile 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 şunlara ihtiyacınız vardır:

  • Geliştirme için kullanacağınız bir Google Hesabı ile ayarlanmış, Android 10 veya sonraki bir sürümü çalıştıran bir 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çıldığından emin olun.
  • Kablosuz ağ.
  • Home API'leri destekleyen bir Google merkezi.

  • 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 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ü (boolean durum)
    • 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şık açma/kapatma (açma ve kapatma, parlaklık)
    • Açma/kapatma düğmeli ışık anahtarı
    • Açma/kapatma priz birimi (açma ve kapatma)
    • 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 izin 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 izin 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 konuma 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 Home API'ler henüz Google tarafından geliştirme için sağlanan standart kitaplıkların bir parçası değildir. Home API'leri kullanarak uygulama 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çmış olmanı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'te tüm proje bağımlılıkları indirilip Gradle derlemesi tamamlanması 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ü seçin. Diğer bir deyişle, com.example.
    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 paketi, dosyada bulunduğu her yerde yeni paket adıyla değiştirin.

  4. Uygulamayı Android Studio'te çalıştırarak bir OAuth anahtarı 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 OAuth anahtarı 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 OAuth sertifikasını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 tür yerel/Android uygulamasıdır.
    2. Google Cloud Console Yardım sitesindeki OAuth 2.0'u ayarlama / Yerel uygulamalar / Android başlıklı makaledeki talimatları uygulayarak SHA-1 parmak izini OAuth istemciye ekleyin. Geliştirme süreci boyunca varsayılan Android Studio anahtarından SHA-1 anahtarı 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 tekrar Projeyi çalıştır'ı tıklayın.

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