Derin bağlantı

Google Home app (GHA), kullanıcıların akıllı cihazları Google Assistant hizmetine bağlamasının ve Google Home Graph uygulamasındaki yapılara ve odalara atamasının birincil yoludur. Kullanıcılar, kurulumu gerçekleştirmek için genellikle birden fazla ekrana tıklayarak mevcut seçenekler listesinden entegrasyonunuzu bulur.Cloud-to-cloud Kullanıcıların kurulum sürecini başlatmasını kolaylaştırarak oryantasyon sürecini hızlandırabilir ve kurulum sırasında yaşayabilecekleri sorunları azaltabilirsiniz.

Derin bağlantı, kullanıcıların smart home cihazlarını Assistant uygulamasına kolayca bağlaması için uygulamanıza veya ürün web sitenize derin bağlantı yerleştirmenize olanak tanır. Kullanıcılar bağlantıyı tıkladığında GHA uygulamasını indirmeleri istenir (uygulama henüz yüklü değilse) ve hesap bağlama ile oda atama kurulum akışı başlatılır.

Google Home'a derin bağlantı

Derin bağlantılar, kullanıcıları Android veya iOS uygulamanızdan doğrudan GHA içindeki belirli bir hedefe yönlendirmenizi sağlayarak cihaz kurulum sürecini basitleştirir.

Hesap bağlama işlemini doğrudan GHA uygulamasında başlatmak için aşağıdaki Geçiş Bağlantısı'nı kullanın:

https://home.google.com/home-app/?deeplink=setup%2Fha_linking%3Fagent_id%3Dagent-id

agent-id, buluttan buluta entegrasyonunuzun proje kimliğidir. Bu kimliği, proje ayarlarındaki Google Home Developer Console bölümünde bulabilirsiniz.

Özel şema (Android ve iOS) kullanarak başlatılan mobil uygulamalar için şunları da kullanabilirsiniz:

googlehome://setup/ha_linking?agent_id=agent-id

Kullanıcılar Geçiş Bağlantısı'nı tıkladığında mobil platform, GHA uygulamasının varlığını kontrol eder ve hesap bağlama akışını açar. Kullanıcının cihazında GHA yüklü değilse kullanıcıyı uygulamayı Google Play veya Apple uygulama mağazasından yüklemeye ya da güncellemeye yönlendirmek için yedek işleme sağlayın.

Android açık intent'i

Açık intent kullanarak hesap bağlama akışını doğrudan Android uygulamanızdan tetiklemek için:

val intent = Intent(Intent.ACTION_VIEW).apply {
    val agentId = "YOUR_AGENT_ID"
    data = Uri.parse("googlehome://setup/ha_linking?agent_id=$agentId")
    setPackage("com.google.android.apps.chromecast.app")
}
try {
    startActivity(intent)
} catch (e: ActivityNotFoundException) {
    // Fallback: open Google Play app, with web browser safety
    try {
        val playStoreIntent = Intent(Intent.ACTION_VIEW,
            Uri.parse("market://details?id=com.google.android.apps.chromecast.app"))
        startActivity(playStoreIntent)
    } catch (e: ActivityNotFoundException) {
        val playStoreUrl =
            "https://play.google.com/store/apps/details?id=com.google.android.apps.chromecast.app"
        val webIntent = Intent(Intent.ACTION_VIEW, Uri.parse(playStoreUrl))
        startActivity(webIntent)
    }
}

madeby.google.com veya assistant.google.com ile biçimlendirilmiş eski derin bağlantı URL'leri kullanımdan kaldırıldı:

https://madeby.google.com/home-app/?deeplink=setup%2Fha_linking%3Fagent_id%3Dagent-id

Tüm uygulama içi düğmeleri ve ürün web sitelerini, Geçiş Bağlantısı'nı veya googlehome://setup/ha_linking özel şemasını kullanacak şekilde güncelleyin.

Uygulamanızın içinden derin bağlantıları tetikleme hakkında daha fazla bilgi için ilgili Android belgelerini ve iOS belgelerini inceleyin.