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

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

الزامات

برای اینکه رابط نیم ورق در یک برنامه ظاهر شود:

• حداقل نسخه Google Play باید 40.4 باشد.
• سطح Android API باید 23 یا بالاتر باشد.

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

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

کاتلین

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

پارامترهای API نصب درون خطی

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

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