دمج روابط لصفحات في التطبيقات المخصّصة للوسائط

يهدف هذا المستند إلى وصف كيفية إضافة مطوّري التطبيقات التابعين لجهات خارجية (3P) روابط لصفحات في تطبيقات الوسائط التي تعمل بنظام التشغيل AAOS. تتيح لك الروابط لصفحات في الوسائط فتح تطبيقات AAOS Media من خلال الروابط لصفحات في التطبيق بالطريقة نفسها التي يتم بها ذلك على جهاز جوّال.

الإصدارات المتوافقة

للحصول على أحدث إصدار متوافق، اطّلِع على أحدث عناصر الإنشاء.

• CarMediaApp.apk
• TestMediaApp.apk

آلية العمل

عند فتح رابط لصفحة في التطبيق على نظام التشغيل AAOS، يتم فتح تطبيق الوسائط الذي يتعامل مع المخطّط المعيّن. بعد ذلك، يفكّ تطبيق الوسائط ترميز عنوان URL، وينشئ عنصر intent للوسائط بالاستناد إلى المعلومات الواردة في هذا الرابط، ثم يستخدم هذا العنصر لفتح شاشة الوسائط.

التنفيذ لتلبية الطلبات الجديدة والإضافات الجديدة:

• يوفّر تنسيقًا معدّلاً للنوايا التي يمكن للوسائط التعامل معها للمطوّرين التابعين لجهات خارجية حتى يتمكّنوا من إرسال المعلومات اللازمة من خلال النية إلى الوسائط.

• تعالج هذه الوظيفة النوايا الواردة من تطبيقات الجهات الخارجية التي تحتوي على عنصر وسائط معيّن أو طلب بحث، ثم تفتح صفحة تتضمّن المعلومات المطلوبة في "الوسائط".

يتحمّل المطوّرون التابعون لجهات خارجية مسؤولية تحديث تطبيقاتهم حتى يمكن تنفيذها باستخدام طلبات بيانات URI للويب وإرسال المعلومات اللازمة إلى "الوسائط" من خلال طلب بيانات.

متطلبات التطبيقات التابعة لجهات خارجية

يتم عرض 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‏، ACTION_MEDIA_TEMPLATE_V2. يتم تضمين MediaIntentExtras.java الإجراء وعناصر Intent الإضافية التالية في فئة MediaIntentExtras.java. ويمكن إضافة هذه الإضافات إلى الطلب.

حالات خاصة

في حال إضافة عدة عناصر إضافية إلى الطلب معًا، مثل تضمين كلاً من EXTRA_KEY_MEDIA_ID وEXTRA_KEY_SEARCH_QUERY في هذا الطلب، يعالج التنفيذ الحالي معرّف الوسائط أولاً، ولا يبدأ الوسائط تنفيذ طلب البحث إلا عندما يكون معرّف الوسائط خاليًا.

الاختبار

بعد اكتمال عملية دمج تطبيق الوسائط التابع لجهة خارجية، استخدِم الأمر adb لإرسال رابط لصفحة في التطبيق. يتم فتح الوسائط التي تتضمّن المعلومات المطلوبة. على سبيل المثال، يلي الأمر الخاص بـ TestMediaApp:

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