پیوندهای عمیق را با برنامه های رسانه ادغام کنید

هدف این سند توصیف این است که چگونه توسعه دهندگان برنامه شخص ثالث (3P) می توانند پیوندهای عمیق به برنامه های رسانه AAOS اضافه کنند. پیوندهای عمیق رسانه به شما این امکان را می دهند که برنامه های رسانه AAOS را از طریق پیوندهای عمیق به همان روشی که در دستگاه تلفن همراه دارید باز کنید.

نسخه های پشتیبانی شده

برای دریافت آخرین نسخه پشتیبانی شده، آخرین Build Artifacts را ببینید.

• CarMediaApp.apk
• TestMediaApp.apk

چگونه کار می کند

هنگامی که یک پیوند عمیق در AAOS باز می شود، برنامه رسانه ای را باز می کند که این طرح خاص را مدیریت می کند. سپس برنامه رسانه URL را رمزگشایی می‌کند، یک هدف رسانه با اطلاعات آن پیوند ایجاد می‌کند و سپس از آن هدف برای باز کردن صفحه رسانه استفاده می‌کند.

پیاده سازی برای پشتیبانی از اهداف جدید و موارد اضافی جدید:

• فرمت به روز شده ای از مقاصد را ارائه می دهد که می تواند توسط رسانه ها برای توسعه دهندگان 3P مدیریت شود تا آنها بتوانند اطلاعات لازم را از طریق intent به رسانه ارسال کنند.

• هدف‌های برنامه‌های 3P را که حاوی یک آیتم رسانه خاص یا یک عبارت جستجو هستند مدیریت می‌کند و سپس صفحه‌ای را با اطلاعات درخواستی در رسانه باز می‌کند.

توسعه دهندگان 3P مسئول به روز رسانی برنامه خود هستند تا برنامه بتواند توسط URI وب فراخوانی شود و اطلاعات لازم را از طریق یک intent به رسانه ارسال کند.

مورد نیاز برای برنامه های 3P

TmaTrampolineActivity در برنامه TestMediaApp به عنوان مثال ارائه شده است.

مرحله 1

توسعه دهندگان باید فعالیتی مشابه TmaTrampolineActivity در TestMediaApp داشته باشند. برای پیوند عمیق، این فعالیت به یک فیلتر قصد در مانیفست نیاز دارد. این فیلتر هدف باید شامل تمام URLهایی باشد که باید مطابق با توضیح در افزودن فیلترهای هدف برای پیوندهای ورودی، مدیریت شوند.

ما پیشنهاد می‌کنیم که فیلتر قصد شامل طرح‌ها و میزبان‌هایی باشد که برنامه نسخه تلفن استفاده می‌کند تا مطمئن شود پیوندهای عمیق در سراسر پلتفرم‌ها کار می‌کنند.

<activity android:name=".automotive.TmaTrampolineActivity"
                  android:exported="true">
            <intent-filter android:label="TmaTrampolineActivity_label">
                <action android:name="android.intent.action.VIEW" />
                <category android:name="android.intent.category.DEFAULT" />
                <category android:name="android.intent.category.BROWSABLE" />
                <data android:scheme="app"
                      android:host="com.android.car.media.testmediaapp"/>
            </intent-filter>
        </activity>

مرحله 2

در این فعالیت، اپلیکیشن Media اطلاعات را از لینک بازیابی می کند و قصدی برای رسانه ایجاد می کند.

رسانه از دو عملکرد پشتیبانی می کند. اولین عملکرد باز کردن یک آیتم رسانه ای با یک آیتم رسانه ای خاص است و دومین عملکرد نشان دادن نتایج جستجوی جستجو است. شناسه مورد رسانه یا رشته درخواست جستجو باید در intent اضافی گنجانده شود.

اطلاعات قصد

برای استفاده از این ویژگی، توسعه‌دهندگان باید جدیدترین نسخه Media را برای پشتیبانی از کنش Intent، ACTION_MEDIA_TEMPLATE_V2 نصب کنند. اقدام Intent و موارد اضافی intent زیر در کلاس MediaIntentExtras.java گنجانده شده است. این موارد اضافی را می توان به قصد اضافه کرد.

موارد خاص

اگر چندین مورد اضافی با هم به intent اضافه شود، مانند هر دو EXTRA_KEY_MEDIA_ID و EXTRA_KEY_SEARCH_QUERY در این intent گنجانده شود، پیاده سازی فعلی ابتدا شناسه رسانه را مدیریت می کند، و تنها زمانی که شناسه رسانه خالی است Media عبارت جستجو را اجرا می کند.

تست کنید

هنگامی که ادغام برنامه رسانه 3P کامل شد، از دستور adb برای ارسال یک پیوند عمیق استفاده کنید. رسانه با اطلاعات مورد نظر باز می شود. به عنوان مثال، این دستور برای TestMediaApp :

adb shell am start -W -a android.intent.action.VIEW -d "https://www.testmediaapp.com/path?search=normal\&searchAction=1"