این صفحه توضیح میدهد که چگونه توسعهدهندگان برنامه میتوانند نصب درونخطی را ادغام کنند، یک ویژگی آزمایشی جدید برای Google Play که جزئیات محصول برنامه Google Play را در یک رابط کاربری نیمصفحهای ارائه میدهد. نصب درونخطی به کاربران این امکان را میدهد که بدون ترک زمینه برنامه، یک جریان نصب یکپارچه برنامه را تجربه کنند. توسعهدهندگان برنامه میتوانند ویژگی نصب درونخطی را برای برنامههای توزیعشده یا بهروزرسانیشده Play ادغام و آزمایش کنند.
الزامات
برای نمایش رابط کاربری نیمصفحه در یک برنامه:
- حداقل نسخه گوگل پلی باید ۴۰.۴ باشد.
- سطح API اندروید باید ۲۴ یا بالاتر باشد.
فراخوانی نصبهای درونخطی از یک برنامه
برای فراخوانی inline install half sheet از یک برنامه، یک نمونه از کلاس 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 ، لینکهای عمیق intent به Google Play ارسال میشود. | بله |
callerId | نام بسته برنامه تماس گیرنده | بله |
listing | یک پارامتر اختیاری برای تعیین هدف برای فهرست فروشگاه سفارشی | خیر |
اگر روند نصب برنامه، رابط نصب درونخطی گوگل پلی را به صورت نیمصفحه نمایش ندهد، به جای آن یک لینک مستقیم (لینک عمیق) به فهرست گوگل پلی نمایش داده میشود.