Google Home app (GHA) היא הדרך העיקרית שבה משתמשים מחברים מכשירים חכמים ל-Google Assistant ומקצים אותם למבנים ולחדרים ב-Google Home Graph. כדי להגדיר את השילוב, המשתמשים בדרך כלל לוחצים על כמה מסכים כדי למצוא את השילוב Cloud-to-cloud שלכם מתוך רשימה של אפשרויות זמינות. כדי לעזור למשתמשים להתחיל את תהליך ההגדרה מהר יותר ולצמצם את התסכול שלהם, כדאי להקל עליהם את תהליך ההצטרפות.
קישורי עומק מאפשרים לכם להטמיע קישור עומק באפליקציה או באתר המוצר כדי שהמשתמשים יוכלו לחבר בקלות את מכשיר smart home אל Assistant. כשלוחצים על הקישור, המשתמשים מתבקשים להוריד את GHA (אם הוא לא מותקן), והתהליך של קישור החשבון והקצאת החדר מתחיל.
קישור עומק ל-Google Home
קישורי עומק מאפשרים לכם להעביר משתמשים ישירות ליעד ספציפי בתוך GHA מהאפליקציה של Android או iOS, וכך לפשט את תהליך הגדרת המכשיר.
כדי להתחיל את קישור החשבון ישירות ב-GHA, משתמשים בקישור האוניברסלי הבא:
https://home.google.com/home-app/?deeplink=setup%2Fha_linking%3Fagent_id%3Dagent-idagent-id הוא מזהה הפרויקט של השילוב בין ענן לענן, שאפשר למצוא בGoogle Home Developer Console בהגדרות הפרויקט.
אם אתם משיקים אפליקציות לנייד באמצעות סכימה בהתאמה אישית (Android ו-iOS), אתם יכולים להשתמש גם ב:
googlehome://setup/ha_linking?agent_id=agent-idכשמשתמשים לוחצים על הקישור האוניברסלי, הפלטפורמה לנייד בודקת אם קיים GHA ופותחת את תהליך קישור החשבון. אם האפליקציה GHA לא מותקנת במכשיר של המשתמש, צריך לספק טיפול חלופי כדי להפנות את המשתמש להתקנה או לעדכון של האפליקציה מ-Google Play או מ-App Store של אפל.
אובייקט Intent מפורש ב-Android
כדי להפעיל את תהליך קישור החשבון ישירות מאפליקציה ל-Android באמצעות אובייקט Intent מפורש:
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)
}
}
קישורי עומק מדור קודם
כתובות URL מדור קודם של קישורים עמוקים בפורמט madeby.google.com או
assistant.google.com הוצאו משימוש:
https://madeby.google.com/home-app/?deeplink=setup%2Fha_linking%3Fagent_id%3Dagent-idמעדכנים את כל הלחצנים באפליקציה ואת אתרי המוצרים לשימוש בקישור האוניברסלי או ב-googlehome://setup/ha_linking סכמה מותאמת אישית.
פרטים נוספים על הפעלת קישורי עומק מתוך האפליקציה זמינים במאמרי העזרה של Android ובמאמרי העזרה של iOS.