پیونددهی عمیق

Google Home app (GHA) روش اصلی‌ای است که کاربران دستگاه‌های هوشمند را به Google Assistant متصل می‌کنند و آن‌ها را به ساختارها و اتاق‌ها در Google Home Graph اختصاص می‌دهند. برای انجام راه‌اندازی، کاربران معمولاً روی چندین صفحه کلیک می‌کنند تا ادغام Cloud-to-cloud شما را از فهرست گزینه‌های دردسترس پیدا کنند. با آسان‌تر کردن شروع فرایند راه‌اندازی برای کاربران، می‌توانید به آماده‌سازی سریع‌تر آن‌ها کمک کنید و سرخوردگی کاربر را در فرایند راه‌اندازی کاهش دهید.

«پیوند عمیق» به شما امکان می‌دهد پیوند عمیقی را در برنامه یا وب‌سایت محصولتان جاسازی کنید تا کاربران بتوانند به‌راحتی دستگاه smart home خود را به Assistant متصل کنند. با کلیک کردن روی پیوند، از کاربران خواسته می‌شود GHA را بارگیری کنند (اگر ازقبل نصب نشده باشد)، و جریان راه‌اندازی پیوند دادن حساب و تخصیص اتاق راه‌اندازی می‌شود.

پیوند عمیق به Google Home

پیوندهای عمیق به شما امکان می‌دهند کاربران را مستقیماً از برنامه iOS یا Android به مقصد خاصی در GHA هدایت کنید و فرایند راه‌اندازی دستگاه را ساده‌تر کنید.

برای شروع پیونددهی حساب مستقیماً در GHA، از «پیوند جامع» زیر استفاده کنید:

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

وقتی کاربران روی «پیوند جامع» کلیک می‌کنند، پلاتفرم تلفن همراه وجود GHA را بررسی می‌کند و جریان پیوند دادن حساب را باز می‌کند. اگر GHA در دستگاه کاربر نصب نشده است، مدیریت بازگشت ارائه دهید تا کاربر را برای نصب یا به‌روزرسانی برنامه از Google Play یا Apple App Store هدایت کند.

قصد آشکار Android

برای راه‌اندازی جریان پیوند دادن حساب مستقیماً از برنامه Android بااستفاده از هدف صریح:

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

پیوندهای عمیق قدیمی

نشانی‌های وب پیوند عمیق قدیمی که با 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 مربوطه مراجعه کنید.