Precyzyjne linki

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

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

Precyzyjny link do Google Home

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

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

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

agent-id to identyfikator projektu integracji 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ą uniwersalny link, platforma mobilna sprawdza, czy jest zainstalowana aplikacja GHA, i otwiera proces łączenia kont. Jeśli aplikacja GHA nie jest zainstalowana na urządzeniu użytkownika, podaj obsługę kreacji zastępczej, aby przekierować użytkownika do instalacji lub aktualizacji aplikacji z Google Play lub Apple App Store.

Intencja jawna na Androidzie

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

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ą wycofane:

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

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

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