تشغيل اختبارات تشغيل الوسائط في CTS Verifier

تتضمّن هذه الصفحة تعليمات حول إجراء اختبارات تشغيل الوسائط في حزمة CTS Verifier (CTS-V) المضمّنة في Android 17.

تتضمّن مجموعة اختبار تشغيل الوسائط في CTS-V ضمن أداة اختبار cts/apps/SecurePlaybackTestApp اختبارًا يضمن عرض اللقطات على شاشة الجهاز بدون فقدان أي لقطات أثناء التشغيل الآمن.

تختبر مجموعة اختبار تشغيل الوسائط واجهات برمجة التطبيقات التالية:

• android.media.MediaCodec#queueSecureInputBuffer
• android.media.MediaDrm#getKeyRequest
• android.media.MediaDrm#provideKeyResponse
• android.media.MediaCrypto#MediaCrypto

تتحقّق حزمة اختبار تشغيل الوسائط من برامج الترميز التالية: AVC وHEVC وVP9 وAV1.

ملاحظة: هذه المجموعة الاختبارية هي اختبار شامل لتشغيل المحتوى المحمي. على عكس اختبارات GTS، يمكن لاختبارات تشغيل الوسائط في CTS Verifier تحليل ما يتم عرضه على شاشة الجهاز.

إعداد بيئة الاختبار

لإجراء اختبارات التشغيل الآمن، عليك إعداد ما يلي:

• جهاز قيد الاختبار
• جهاز مضيف
• أداة تحليل التشغيل (PAT) (ننصحك بشراء أداة PAT من Tempo Manufacturing).

إعداد الجهاز الخاضع للاختبار

لإعداد DUT، اتّبِع الخطوات التالية:

1. وصِّل الجهاز قيد الاختبار بجهاز مضيف عبر USB.
2. امنح المضيف أذونات للوصول إلى الجهاز الخاضع للاختبار عبر تصحيح أخطاء Android.
3. ثبِّت تطبيق CTS-V (CtsVerifier.apk) على الجهاز. لمزيد من المعلومات، يُرجى الاطّلاع على إجراء اختبارات CTS-V.
4. وصِّل الجهاز قيد الاختبار بالإنترنت.
5. اربط جهاز PAT بالمضيف.
   1. عندما يكون الجهاز قيد الاختبار في وضع عمودي، ضَع الجانب المبطّن من أداة PAT بشكل مسطّح على الشاشة مع توجيه السهم الأبيض الخاص بالأداة إلى الأعلى.
   2. لفّ الشريطين حول الجهاز قيد الاختبار واسحب السلك الذي ينتهي بطرف أبيض لإحكام الربط.

إعداد المضيف

لإعداد بيئة الاختبار، نزِّل ملفات إعداد PAT واستخرِج المحتوى إلى دليل pat-cts جديد:

cd pat-cts/v2.4.0
./setup.sh

يُعدّ هذا الأمر واجهة سطر الأوامر الخاصة بأداة PAT ويُدخل بيئة افتراضية مع تثبيت Python. إذا لم يتم إدخال البيئة تلقائيًا، شغِّل ما يلي:

source venv/bin/activate

ننصحك بتعديل PAT ليتوافق مع إصدار البرامج الثابتة المضمّن في ملفات الإعداد. للاطّلاع على إصدار البرامج الثابتة، نفِّذ الأمر التالي:

(venv) patctl --usb --info | grep "Firmware version"

إذا كان إصدار البرامج الثابتة أقل من 2.4.0، يجب تحديث البرامج الثابتة. التشغيل:

(venv) patctl --usb --update pat_fw_v2.4.0rc2.bin

لإجراء اختبار CTS، عليك تثبيت إطار عمل اختبار Mobly وsnippet-uiautomator في البيئة الافتراضية:

(venv) pip install mobly
(venv) pip install snippet-uiautomator

قبل تشغيل الاختبارات، يجب أيضًا ضبط متغيّر بيئة يحدّد موقع مواد العرض الاختبارية أثناء تفعيل البيئة الافتراضية. لإجراء ذلك، نفِّذ الأمر التالي:

(venv) cd SecurePlaybackTestApp
(venv) source build/envsetup.sh

لإعادة الدخول إلى البيئة، نفِّذ ما يلي:

source pat-cts/v2.4.0/venv/bin/activate

إنشاء ملفات الإعداد

باستخدام إطار عمل Mobly، عليك إنشاء ملف إعداد config.yml لتحديد منصة اختبار Mobly.

في ما يلي مثال على ملف config.yml. يتم توفير نموذج في الدليل SecurePlaybackTestApp/.

TestBeds:
  # A testbed where adb will find Android devices.
  - Name: PlaybackAnalysisTestBed
    Controllers:
        AndroidDevice:
        - serial: 8A9X0NS5Z  # quotes are needed if serial id is entirely numeric
          label: dut
    TestParams:
        video_scaling: 1.0  # from 0.0 to 1.0, used if the test video is too large to fit the Playback Analysis Tool

إجراء الاختبارات

لتشغيل اختبارات تشغيل الوسائط في CTS-V، اتّبِع الخطوات التالية:

1. من داخل بيئة Python الافتراضية على الجهاز المضيف، انتقِل إلى الدليل SecurePlaybackTestApp/.

2. إجراء الاختبار:

   python ./secure_playback_test.py -c config.yml

   بعد حوالي 10 ثوانٍ، يبدأ تشغيل فيديو على الجهاز.

3. وازِن بين الأخاديد الموجودة على أداة PAT والأشرطة الخمسة السوداء والبيضاء في الفيديو كما هو موضّح في الرسم التخطيطي التالي. تأكَّد من محاذاة PAT مع السهم المتّجه إلى اليسار بالنسبة إلى اتجاه الفيديو.

   

   الشكل 1: إعلانات PAT محاذية بشكل صحيح

   ملاحظة: إذا كانت أشرطة الفيديو عريضة جدًا ولا تتناسب مع الأخاديد، كما هو موضّح في المخطّط البياني أدناه، سيطلب منك النص البرمجي إدخال رقم بين 0.0 و1.0 لتصغير حجم الفيديو إلى أن تتناسب الأخاديد مع عرض الشريط. يمكنك أيضًا ضبط قيمة video_scaling هذه في config.yml، كما هو موضّح في مقالة إنشاء ملفات الإعدادات.

   

   الشكل 2: يجب توسيع نطاق PAT.

4. بعد محاذاة أداة PAT، لفّ السلكَين حول الجهاز وشدّهما باستخدام لسان السحب الممتد من الجانب الأيسر من الأداة. تأكَّد من عدم تغيير المحاذاة، وأعِد المحاذاة إذا لزم الأمر. يمكنك فصل جهاز ChromeOS عن الجهاز المضيف لإجراء ذلك، ولكن تأكَّد من إعادة توصيل جهاز ChromeOS قبل المتابعة. تأكَّد من أنّ أداة اختبار PAT مسطّحة تمامًا على الجهاز قيد الاختبار، كما هو موضّح في الشكل 4. ضَع الجهاز في مكان لا يمكن لأحد لمسه لبضع دقائق، ثم أدخِل y لمواصلة الاختبار. تأكَّد من عدم تحرّك الجهاز بعد المحاذاة.

   

   الشكل 3: صورة علوية لجهاز PAT وجهاز DUT

   

   الشكل 4. PAT وDUT، عرض من الجانب

   ملاحظة: يجب أن يضيء مؤشر PAT باللون الأخضر في غضون خمس ثوانٍ. إذا ظلّ المؤشر أحمر، تحقَّق من المحاذاة مرة أخرى وأعِد تشغيل الاختبار. تأكَّد من أنّ السهم يشير إلى الاتجاه الصحيح، كما هو موضّح في الشكل 1.

عند اجتياز الاختبار، يتم تفعيل الزر اجتياز. سجِّل اختبارًا ناجحًا من خلال النقر على هذا الزر.