การทำ Deep Link

Google Home app (GHA) เป็นวิธีหลักที่ผู้ใช้ใช้เชื่อมต่ออุปกรณ์อัจฉริยะกับ Google Assistant และกำหนดอุปกรณ์ให้กับบ้านและห้องใน Google Home Graph ในการตั้งค่า โดยปกติแล้วผู้ใช้จะคลิกผ่านหน้าจอหลายหน้าเพื่อค้นหาการผสานรวม Cloud-to-cloud ของคุณจากรายการตัวเลือกที่มี การทำให้ผู้ใช้เริ่มกระบวนการตั้งค่าได้ง่ายขึ้นจะช่วยให้ผู้ใช้เริ่มต้นใช้งานได้เร็วขึ้นและลดความหงุดหงิดในการตั้งค่าของผู้ใช้

การทำ Deep Link ช่วยให้คุณฝัง Deep Link ในแอปหรือเว็บไซต์ผลิตภัณฑ์เพื่อให้ผู้ใช้เชื่อมต่ออุปกรณ์ smart home กับ Assistant ได้อย่างง่ายดาย การคลิกลิงก์จะแจ้งให้ผู้ใช้ดาวน์โหลด GHA (หากยังไม่ได้ติดตั้ง) และเปิดขั้นตอนการตั้งค่าการลิงก์บัญชีและการกำหนดห้อง

Deep Link ไปยัง Google Home

Deep Link ช่วยให้คุณนำผู้ใช้ไปยังปลายทางที่เฉพาะเจาะจงภายในGHAจากAndroidหรือแอป iOS ได้โดยตรง ซึ่งจะช่วยลดความซับซ้อนของกระบวนการตั้งค่าอุปกรณ์

หากต้องการเริ่มการลิงก์บัญชีใน GHA โดยตรง ให้ใช้ Universal Link ต่อไปนี้

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

โดย agent-id คือรหัสโปรเจ็กต์ของการผสานรวมระบบคลาวด์กับระบบคลาวด์ ซึ่งดูได้ใน Google Home Developer Console ในส่วนการตั้งค่าโปรเจ็กต์

สำหรับแอปพลิเคชันบนอุปกรณ์เคลื่อนที่ที่เปิดตัวโดยใช้รูปแบบที่กำหนดเอง (Android และ iOS) คุณยังใช้สิ่งต่อไปนี้ได้ด้วย

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

เมื่อผู้ใช้คลิก Universal Link แพลตฟอร์มบนอุปกรณ์เคลื่อนที่จะตรวจสอบว่ามี GHA หรือไม่ และเปิดขั้นตอนการลิงก์บัญชี หากไม่ได้ติดตั้ง GHA ในอุปกรณ์ของผู้ใช้ ให้ระบุการจัดการสำรองเพื่อกำหนดเส้นทางให้ผู้ใช้ติดตั้งหรืออัปเดตแอปจาก Google Play หรือ Apple 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 ของ Deep Link เดิมที่จัดรูปแบบด้วย madeby.google.com หรือ assistant.google.com จะเลิกใช้งานแล้ว

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

อัปเดตปุ่มแอปในแอปและเว็บไซต์ผลิตภัณฑ์ทั้งหมดให้ใช้ Universal Link หรือรูปแบบที่กำหนดเอง googlehome://setup/ha_linking

ดูรายละเอียดเพิ่มเติมเกี่ยวกับการเรียกใช้ Deep Link จากภายในแอปได้ที่เอกสารประกอบของ Android และเอกสารประกอบของ iOS ที่เกี่ยวข้อง