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 thiết bị cho các 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 Cloud-to-cloud tích hợp 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ự thất vọng 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 của họ 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à bắt đầu quy trình thiết lập liên kết tài khoản và chỉ định phòng.

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

Đường liên kết sâu cho phé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 phổ quát sau:

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

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

Đối với các ứng dụng di động chạy bằng 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 xem có GHA hay không 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 tính năng xử lý dự phòng để đưa người dùng đến trang cài đặt hoặc cập nhật ứng dụng trên Google Play hoặc Apple App Store.

Ý định tường minh trên Android

Cách kích hoạt quy trình liên kết tài khoản ngay trong ứng dụng Android bằng một ý định rõ ràng:

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 đường liên kết sâu cũ được định dạng bằng madeby.google.com hoặc assistant.google.com không còn đượ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 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 liên quan về Android và tài liệu liên quan về iOS.