Precyzyjne linki

Google Home app (GHA) to główny sposób, w jaki użytkownicy łączą urządzenia inteligentne z Google Assistant i przypisują je do struktur i pomieszczeń w Google Home Graph. Aby skonfigurować integrację, użytkownicy zwykle muszą przejść przez kilka ekranów i znaleźć jąCloud-to-cloud na liście dostępnych opcji. Ułatwiając użytkownikom rozpoczęcie procesu konfiguracji, możesz przyspieszyć ich wdrażanie i zmniejszyć frustrację związaną z konfiguracją.

Precyzyjne linki umożliwiają umieszczenie w aplikacji lub witrynie produktu precyzyjnego linku, dzięki któremu użytkownicy mogą łatwo połączyć swoje smart home urządzenie z Assistant. Kliknięcie linku powoduje wyświetlenie prośby o pobranie aplikacji GHA (jeśli nie jest jeszcze zainstalowana) oraz uruchomienie procesu łączenia konta i przypisywania pomieszczeń.

Precyzyjny link do Google Home

Precyzyjne linki umożliwiają kierowanie użytkowników bezpośrednio do określonego miejsca w GHA z aplikacji na Android lub iOS, co upraszcza proces konfiguracji urządzenia.

Aby rozpocząć łączenie konta bezpośrednio w aplikacji GHA, użyj tego linku uniwersalnego:

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

gdzie agent-id to identyfikator projektu integracji typu Cloud-to-cloud, który znajdziesz w Google Home Developer Console w ustawieniach projektu.

W przypadku aplikacji mobilnych uruchamianych za pomocą schematu niestandardowego (Android i iOS) możesz też użyć:

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

Gdy użytkownicy klikną link uniwersalny, platforma mobilna sprawdzi, czy aplikacja Google Home jest zainstalowana i otworzy proces łączenia kontaGHA. Jeśli aplikacja Google HomeGHA nie jest zainstalowana na urządzeniu użytkownika, zapewnij obsługę rezerwową, aby przekierować użytkownika do Google Play lub Apple App Store, gdzie może zainstalować lub zaktualizować aplikację.

Intencja bezpośrednia na Androidzie

Aby uruchomić proces łączenia konta bezpośrednio z aplikacji na Androida za pomocą intencji bezpośredniej:

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)
    }
}

Starsze adresy URL precyzyjnych linków sformatowane za pomocą madeby.google.com lub assistant.google.com są wycofywane:

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

Zaktualizuj wszystkie przyciski w aplikacji i witryny produktów, aby używały linku uniwersalnego lub schematu niestandardowego googlehome://setup/ha_linking.

Więcej informacji o uruchamianiu precyzyjnych linków z poziomu aplikacji znajdziesz w odpowiedniej dokumentacji na Androida i iOS.