Liên kết sâu

Google Home app (GHA) là cách chính để người dùng kết nối thiết bị thông minh với Google Assistant và chỉ định các thiết bị đó cho cấu trúc và phòng trong Google Home Graph. Để thiết lập, người dùng thường nhấp qua nhiều màn hình để tìm chế độ tích hợp Cloud-to-cloud của bạn trong danh sách các lựa chọn có sẵn. Bằng cách giúp người dùng dễ dàng bắt đầu quy trình thiết lập, bạn có thể giúp họ làm quen nhanh hơn và giảm bớt sự khó chịu khi thiết lập.

Tính năng Liên kết sâu cho phép bạn nhúng một đường liên kết sâu vào ứng dụng hoặc trang web sản phẩm để người dùng dễ dàng kết nối thiết bị smart home với Assistant. Khi nhấp vào đường liên kết, người dùng sẽ được nhắc tải GHA xuống (nếu chưa cài đặt) và quy trình thiết lập liên kết tài khoản và chỉ định phòng sẽ bắt đầu.

Đường liên kết sâu đến Google Home

Đường liên kết sâu giúp bạn đưa người dùng đến thẳng một đích đến cụ thể trong GHA từ Android hoặc ứng dụng iOS, giúp đơn giản hoá quy trình thiết lập thiết bị.

Để bắt đầu liên kết tài khoản ngay trong GHA, hãy sử dụng Đường liên kết chung sau:

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

Trong đó, agent-id là Mã dự án của chế độ tích hợp Đám mây với đám mây. Bạn có thể tìm thấy mã này trong Google Home Developer Console trong phần cài đặt dự án.

Đối với các ứng dụng di động khởi chạy bằng một lược đồ tuỳ chỉnh (Android và iOS), bạn cũng có thể sử dụng:

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

Khi người dùng nhấp vào Đường liên kết phổ quát, nền tảng di động sẽ kiểm tra sự hiện diện của GHA và mở quy trình liên kết tài khoản. Nếu GHA chưa được cài đặt trên thiết bị của người dùng, hãy cung cấp cơ chế xử lý dự phòng để định tuyến người dùng cài đặt hoặc cập nhật ứng dụng từ Google Play hoặc Apple App Store.

Ý định tường minh của Android

Để kích hoạt quy trình liên kết tài khoản ngay từ ứng dụng Android của bạn bằng một ý định tường minh:

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

Các URL liên kết sâu cũ được định dạng bằng madeby.google.com hoặc assistant.google.com không được dùng nữa:

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

Cập nhật tất cả các nút trong ứng dụng và trang web sản phẩm để sử dụng Đường liên kết phổ quát hoặc lược đồ tuỳ chỉnh googlehome://setup/ha_linking.

Để biết thêm thông tin chi tiết về cách kích hoạt đường liên kết sâu trong ứng dụng, hãy xem tài liệu Android và tài liệu iOS có liên quan.