نصب‌های به‌خط Google Play (برنامه‌ها)

این صفحه توضیح می‌دهد که توسعه‌دهندگان برنامه چگونه می‌توانند نصب به‌خط را ادغام کنند، ویژگی آزمایشی جدیدی برای Google Play که جزئیات محصول برنامه Google Play را در میانای نیم‌برگ ارائه می‌دهد. نصب درون‌خطی به کاربران امکان می‌دهد بدون ترک کردن بافت برنامه، جریان نصب برنامه یکپارچه‌ای را تجربه کنند. توسعه‌دهندگان برنامه می‌توانند ویژگی نصب درون‌خطی را برای برنامه‌های توزیع‌شده یا به‌روزشده Play ادغام و آزمایش کنند.

الزامات

برای اینکه میانای نیم‌برگ در برنامه نشان داده شود:

• حداقل نسخه Google Play باید ۴۰.۴ باشد.
• سطح میانای برنامه‌سازی کاربردی Android باید ۲۴ یا بالاتر باشد.

فراخوانی نصب‌های به‌خط از برنامه

برای فراخوانی نیم‌برگ نصب درون‌خطی از برنامه، نمونه‌ای از کلاس Intent ایجاد کنید که نشانی وب پیوند عمیق را باز می‌کند. از کد نمونه زیر (Kotlin یا Java) به‌عنوان دستورالعمل استفاده کنید.

کاتلین

val intent = Intent(Intent.ACTION_VIEW)
val referrer = "<Your referrer string>"
val id = "<Package name of the app that is to be installed>"
val callerId = "<Package name of your app>"
intent.setPackage("com.android.vending")
val deepLinkUrl = "https://play.google.com/d?id=$id&referrer=$referrer&listing=$csl_id"
intent.data = Uri.parse(deepLinkUrl)
intent.putExtra("overlay", true)
intent.putExtra("callerId", "$callerId")
val packageManager = context.getPackageManager()
if (intent.resolveActivity(packageManager) != null) {
  startActivityForResult(intent, 0)
} else {
  // Fallback to deep linking to full Play Store.
}

جاوا

Intent intent = new Intent(Intent.ACTION_VIEW);
String referrer = "<Your referrer string>";
String id = "<Package name of the app that is to be installed>";
String callerId = "<package name of your app>";
String csl_id = "<Custom store listing id>";
intent.setPackage("com.android.vending");
String deepLinkUrl = "https://play.google.com/d?id=" + id + "&referrer=" + referrer + "&listing=" + csl_id;
intent.setData(Uri.parse(deepLinkUrl));
intent.putExtra("overlay", true);
intent.putExtra("callerId", callerId);
PackageManager packageManager = context.getPackageManager();
if (intent.resolveActivity(packageManager) != null) {
  startActivityForResult(intent, 0);
} else {
  // Fallback to deep linking to full Play Store.
}

پارامترهای Inline Install API

فیلد	شرح	الزامی
referrer	رشته ردیابی ارجاع‌دهنده اختیاری	نه
id	نام بسته برنامه‌ای که باید نصب شود	بله
overlay	اگر نیم‌برگ درون‌خطی درخواست شده باشد، روی true تنظیم می‌شود؛ اگر false، هدف پیوند عمیق به Google Play است	بله
callerId	نام بسته برنامه تماس‌گیرنده	بله
listing	پارامتری اختیاری برای مشخص کردن هدف فهرستگان سفارشی فروشگاه	نه

اگر جریان نصب برنامه، میانای نیم‌برگ نصب درون‌خطی Google Play را نمایش ندهد، به‌جای آن پیوند مستقیم (پیوند عمیق) به فهرستگان Google Play نشان داده می‌شود.