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

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

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

پیوند عمیق به صفحه اصلی گوگل

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

برای شروع اتصال مستقیم حساب کاربری در GHA ، از لینک جهانی زیر استفاده کنید:

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

که در آن agent-id ، شناسه پروژه ادغام Cloud-to-cloud شما است که می‌توانید آن را در Google Home Developer Console در قسمت تنظیمات پروژه پیدا کنید.

برای راه‌اندازی برنامه‌های تلفن همراه با استفاده از یک طرح سفارشی (اندروید و iOS)، می‌توانید از موارد زیر نیز استفاده کنید:

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

وقتی کاربران روی لینک جهانی کلیک می‌کنند، پلتفرم موبایل وجود GHA را بررسی می‌کند و جریان اتصال حساب را باز می‌کند. اگر GHA روی دستگاه کاربر نصب نشده باشد، امکانی برای مدیریت مجدد فراهم کنید تا کاربر را برای نصب یا به‌روزرسانی برنامه از گوگل پلی یا اپ استور اپل هدایت کند.

قصد صریح اندروید

برای فعال کردن جریان لینک حساب کاربری مستقیماً از برنامه اندروید خود با استفاده از یک 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)
    }
}

لینک‌های عمیق قدیمی

آدرس‌های اینترنتی پیوند عمیق قدیمی که با 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 استفاده کنند.

برای جزئیات بیشتر در مورد ایجاد لینک‌های عمیق از درون برنامه، به مستندات مربوطه در اندروید و iOS مراجعه کنید.