إطار عمل أداة الاستقبال

في نظام التشغيل Android 11 أو الإصدارات الأحدث، يمكنك استخدام إطار عمل Android Tuner لتقديم محتوى الصوت والفيديو. يستخدم إطار العمل مسار الأجهزة من المورّدين، ما يجعله مناسبًا لكل من شرائح النظام المنخفضة والعالية الأداء. يوفّر إطار العمل طريقة آمنة لتقديم محتوى صوتي ومرئي محمي بواسطة بيئة تنفيذ موثوقة (TEE) ومسار وسائط آمن (SMP)، ما يتيح استخدامه في بيئة مقيّدة للغاية لحماية المحتوى.

تؤدي الواجهة الموحّدة بين Tuner وAndroid CAS إلى تسريع عملية الدمج بين مورّدي Tuner ومورّدي CAS. تعمل واجهة Tuner مع MediaCodec وAudioTrack لإنشاء حلّ واحد لمنصّة Android TV. تتوافق واجهة Tuner مع كل من التلفزيون الرقمي والتلفزيون التناظري استنادًا إلى معايير البث الرئيسية.

المكونات

في نظام التشغيل Android 11، تم تصميم ثلاثة مكونات خصيصًا لمنصة التلفزيون.

• طبقة HAL الخاصة بجهاز استقبال البث: هي واجهة بين إطار العمل والمورّدين.
• واجهة برمجة التطبيقات لحزمة تطوير البرامج (SDK) الخاصة ببرنامج الضبط: هي واجهة بين إطار العمل والتطبيقات
• Tuner Resource Manager (TRM): ينسّق موارد أجهزة Tuner

تم تحسين المكوّنات التالية في Android 11.

• CAS V2
• TvInputService أو خدمة إدخال التلفزيون (TIS)
• TvInputManagerService أو خدمة "إدارة إدخال التلفزيون" (TIMS)
• MediaCodec أو ترميز الوسائط
• AudioTrack أو مقطع صوتي
• MediaResourceManager أو "مدير موارد الوسائط" (MRM)

الشكل 1: التفاعلات بين مكوّنات Android TV

الميزات

يتوافق الواجهة الأمامية مع معايير DTV أدناه.

• ATSC
• ATSC3
• DVB C/S/T
• ISDB S/S3/T
• ساعة عادية

تتيح الواجهة الأمامية في Android 12 التي تتضمّن الإصدار 1.1 أو إصدارًا أحدث من Tuner HAL استخدام معيار DTV أدناه.

• DTMB

يتوافق Demux مع بروتوكولات البث أدناه.

• بث النقل (TS)
• بروتوكول نقل وسائط MPEG (MMTP)
• بروتوكول الإنترنت (IP)
• قيمة طول النوع (TLV)
• بروتوكول طبقة الربط (ALP) في معيار ATSC

يتوافق برنامج فك التشفير مع وسائل حماية المحتوى أدناه.

• مسار الوسائط الآمن
• محو مسار الوسائط
• سجلّ محلي آمن
• تشغيل المحتوى المحلي بشكل آمن

تتيح واجهات برمجة التطبيقات الخاصة بأجهزة الضبط حالات الاستخدام أدناه.

• فحص
• مباشر
• التشغيل
• تسجيل

تتيح أدوات الضبط وMediaCodec وAudioTrack أوضاع تدفّق البيانات أدناه.

• حمولة ES مع مخزن مؤقت للذاكرة فارغ
• حمولة ES مع معرّف آمن للذاكرة
• رؤية العالم المحيط

التصميم العام

يتم تحديد طبقة HAL الخاصة بأداة Tuner بين إطار عمل Android والأجهزة التابعة للمورّد.

• تصف هذه السمة ما يتوقّعه إطار العمل من المورّد وكيف يمكن للمورّد تنفيذ ذلك.
• تصدّر هذه السمة وظائف الواجهة الأمامية وإزالة التداخل وإزالة التشويش إلى إطار العمل من خلال الواجهات IFrontend وIDemux وIDescrambler وIFilter وIDvr وILnb.
• تتضمّن هذه الواجهة الدوال اللازمة لدمج طبقة HAL الخاصة بأداة Tuner مع مكوّنات أخرى من إطار العمل، مثل MediaCodec وAudioTrack.

يتم إنشاء فئة Tuner Java وفئة أصلية.

• تتيح واجهة برمجة التطبيقات Tuner Java API للتطبيقات الوصول إلى طبقة تجريد الأجهزة (HAL) الخاصة بـ Tuner من خلال واجهات برمجة التطبيقات العامة.
• تسمح الفئة الأصلية بالتحكّم في الأذونات ومعالجة كميات كبيرة من بيانات التسجيل أو التشغيل باستخدام Tuner HAL.
• وحدة Native Tuner هي جسر بين فئة Tuner Java وTuner HAL.

يتم إنشاء فئة TRM.

• تدير موارد Tuner المحدودة، مثل Frontend وLNB وجلسات CAS وجهاز إدخال بيانات التلفزيون من TV Input HAL.
• تطبيق قواعد لاسترداد الموارد غير الكافية من التطبيقات القاعدة التلقائية هي أن يكون التطبيق في المقدّمة هو الفائز.

تم تحسين Media CAS وCAS HAL باستخدام الميزات أدناه.

• يفتح جلسات CAS لاستخدامات وخوارزميات مختلفة.
• يتوافق مع أنظمة CAS الديناميكية، مثل إزالة CICAM وإدخالها.
• يتكامل مع Tuner HAL من خلال توفير رموز مميزة للمفاتيح.

تم تحسين MediaCodec وAudioTrack باستخدام الميزات أدناه.

• تأخذ هذه السمة ذاكرة A/V آمنة كمدخل للمحتوى.
• تم ضبطه على مزامنة الصوت والفيديو على مستوى الجهاز في وضع التشغيل عبر الأنفاق.
• تم ضبط إمكانية استخدام ES_payload ووضع "نقل البيانات".

الشكل 2: مخطّط لمكوّنات Tuner HAL

سير العمل العام

توضّح المخططات البيانية أدناه تسلسلات المكالمات لتشغيل البث المباشر.

الإعداد

الشكل 3: ترتيب الإعدادات لتشغيل البث المباشر

التعامل مع الصوت والفيديو

الشكل 4. التعامل مع الصوت والفيديو لتشغيل البث المباشر

التعامل مع المحتوى المشوّش

الشكل 5. التعامل مع المحتوى المشوّش لتشغيل البث المباشر

معالجة بيانات الصوت والفيديو

الشكل 6. معالجة الصوت والفيديو لتشغيل البث المباشر

Tuner SDK API

تتعامل واجهة برمجة التطبيقات Tuner SDK مع التفاعلات مع Tuner JNI وTuner HAL وTunerResourceManager. يستخدم تطبيق TIS واجهة برمجة التطبيقات Tuner SDK للوصول إلى موارد Tuner ومكوناته الفرعية، مثل الفلتر وجهاز فك التشفير. الواجهة الأمامية وdemux هما مكوّنان داخليان.

الشكل 7. التفاعلات مع واجهة برمجة التطبيقات Tuner SDK

الإصدارات

بدءًا من Android 12، تتيح واجهة برمجة التطبيقات الخاصة بحزمة تطوير البرامج (SDK) لأداة Tuner ميزة جديدة في الإصدار 1.1 من طبقة تجريد الأجهزة (HAL) لأداة Tuner، وهو إصدار مطوّر ومتوافق مع الإصدار السابق من أداة Tuner 1.0.

استخدِم واجهة برمجة التطبيقات التالية للتحقّق من إصدار طبقة تجريد الأجهزة (HAL) قيد التشغيل.

• android.media.tv.tuner.TunerVersionChecker.getTunerVersion()

يمكنك العثور على الحد الأدنى المطلوب لإصدار HAL في مستندات واجهات برمجة التطبيقات الجديدة في Android 12.

إدارة الحِزم

توفّر واجهة برمجة التطبيقات الخاصة بحزمة تطوير البرامج (SDK) لأداة Tuner الحِزم الأربع أدناه.

• android.media.tv.tuner
• android.media.tv.tuner.frontend
• android.media.tv.tuner.filter
• android.media.tv.tuner.dvr

الشكل 8. حِزم واجهة برمجة التطبيقات الخاصة بحزمة تطوير البرامج (SDK) لأداة Tuner

Android.media.tv.tuner

حزمة Tuner هي نقطة دخول لاستخدام إطار عمل Tuner. يستخدم تطبيق TIS الحزمة لتهيئة مثيلات الموارد والحصول عليها من خلال تحديد الإعداد الأولي ومعاودة الاتصال.

• tuner(): تهيئة مثيل Tuner من خلال تحديد المَعلمتَين useCase وsessionId
• tune(): للحصول على مورد من الواجهة الأمامية وضبطه من خلال تحديد المَعلمة FrontendSetting.
• ‫openFilter(): للحصول على مثيل فلتر من خلال تحديد نوع الفلتر.
• ‫openDvrRecorder(): للحصول على مثيل تسجيل من خلال تحديد حجم المخزن المؤقت.
• ‫openDvrPlayback(): للحصول على مثيل تشغيل من خلال تحديد حجم المخزن المؤقت.
• openDescrambler(): الحصول على مثيل لبرنامج فك التشفير
• ‫openLnb(): للحصول على مثيل LNB داخلي
• openLnbByName(): الحصول على مثيل LNB خارجي
• ‫openTimeFilter(): الحصول على مثيل لفلتر الوقت

توفّر حزمة Tuner وظائف لا تغطيها حِزم الفلتر ومسجّل الفيديو الرقمي والواجهة الأمامية. وفي ما يلي قائمة بالوظائف.

• cancelTuning
• scan / cancelScanning
• getAvSyncHwId
• getAvSyncTime
• connectCiCam1 / disconnectCiCam
• shareFrontendFromTuner
• updateResourcePriority
• setOnTuneEventListener
• setResourceLostListener

Android.media.tv.tuner.frontend

تتضمّن حزمة الواجهة الأمامية مجموعات من الإعدادات والمعلومات والحالات والأحداث والإمكانات ذات الصلة بالواجهة الأمامية.

صفوف

يتم اشتقاق FrontendSettings لمعايير DTV المختلفة من خلال الفئات أدناه.

• AnalogFrontendSettings
• Atsc3FrontendSettings
• AtscFrontendSettings
• DvbcFrontendSettings
• DvbsFrontendSettings
• DvbtFrontendSettings
• Isdbs3FrontendSettings
• IsdbsFrontendSettings
• IsdbtFrontendSettings

بدءًا من الإصدار 12 من نظام التشغيل Android مع الإصدار 1.1 أو الإصدارات الأحدث من Tuner HAL، يتوفّر معيار DTV التالي.

• DtmbFrontendSettings

يتم اشتقاق FrontendCapabilities لمعايير DTV المختلفة من خلال الفئات أدناه.

• AnalogFrontendCapabilities
• Atsc3FrontendCapabilities
• AtscFrontendCapabilities
• DvbcFrontendCapabilities
• DvbsFrontendCapabilities
• DvbtFrontendCapabilities
• Isdbs3FrontendCapabilities
• IsdbsFrontendCapabilities
• IsdbtFrontendCapabilities

بدءًا من الإصدار 12 من نظام التشغيل Android مع الإصدار 1.1 أو الإصدارات الأحدث من Tuner HAL، يتوفّر معيار DTV التالي.

• DtmbFrontendCapabilities

تعرض FrontendInfo معلومات الواجهة الأمامية. يستردّ FrontendStatus الحالة الحالية للواجهة الأمامية. تستمع OnTuneEventListener إلى الأحداث في الواجهة الأمامية. يستخدم تطبيق TIS ScanCallback لمعالجة رسائل الفحص من الواجهة الأمامية.

البحث عن القنوات

لإعداد تلفزيون، يبحث التطبيق عن الترددات المتاحة وينشئ قائمة بالقنوات يمكن للمستخدمين الوصول إليها. قد تستخدم خدمة TIS Tuner.tune أو Tuner.scan(BLIND_SCAN) أو Tuner.scan(AUTO_SCAN) لإكمال عملية فحص القنوات.

إذا كان لدى TIS معلومات دقيقة عن التسليم للإشارة، مثل التردد والمعيار (على سبيل المثال، T/T2 أو S/S2) ومعلومات إضافية ضرورية (على سبيل المثال، معرّف PLD)، يُنصح باستخدام Tuner.tune كخيار أسرع.

عندما يتصل المستخدم بالرقم Tuner.tune، تحدث الإجراءات التالية:

• تعبئ "أداة إدارة معلومات الطلاب" FrontendSettings بالمعلومات المطلوبة باستخدام Tuner.tune.
• تعرض طبقة تجريد الأجهزة (HAL) رسائل LOCKED إذا كانت الإشارة مقفلة.
• تستخدم أداة "نظام تذاكر الدعم" Frontend.getStatus لجمع المعلومات اللازمة.
• ينتقل نظام معلومات حركة المرور إلى التردد المتاح التالي في قائمة الترددات.

تتصل خدمة TIS Tuner.tune مرة أخرى إلى أن يتم استنفاد جميع الترددات.

أثناء الضبط، يمكنك الاتصال بالرقم stopTune() أو close() لإيقاف المكالمة Tuner.tune مؤقتًا أو إنهائها.

Tuner.scan(AUTO_SCAN)

إذا لم تتوفّر لدى TIS معلومات كافية لاستخدام Tuner.tune، ولكن توفّرت قائمة بالترددات ونوع عادي (مثل DVB T/C/S)، يُنصح باستخدام Tuner.scan(AUTO_SCAN).

عندما يتصل المستخدم بالرقم Tuner.scan(AUTO_SCAN)، تحدث الإجراءات التالية:

• تستخدِم TIS Tuner.scan(AUTO_SCAN) مع FrontendSettings مملوءًا بالتردد.

• يُبلغ HAL عن رسائل الفحص LOCKED إذا كانت الإشارة مقفلة. قد يعرض HAL أيضًا رسائل مسح ضوئي أخرى لتقديم معلومات إضافية حول الإشارة.

• تستخدم "خدمة معلومات الضرائب" Frontend.getStatus لجمع المعلومات اللازمة.

• تطلب خدمة TIS من HAL تنفيذ Tuner.scan لمواصلة الانتقال إلى الإعداد التالي بالوتيرة نفسها. إذا كانت بنية FrontendSettings فارغة، يستخدم HAL الإعداد التالي المتاح. بخلاف ذلك، يستخدم HAL FrontendSettings لإجراء عملية فحص لمرة واحدة ويرسل END للإشارة إلى أنّ عملية الفحص قد انتهت.

• تكرّر خدمة TIS الإجراءات المذكورة أعلاه إلى أن يتم استنفاد جميع الإعدادات المتعلقة بالتكرار.

• يرسل HAL END للإشارة إلى انتهاء عملية الفحص.

• ينتقل نظام معلومات حركة المرور إلى التردد المتاح التالي في قائمة الترددات.

تتصل خدمة TIS Tuner.scan(AUTO_SCAN) مرة أخرى إلى أن يتم استنفاد جميع الترددات.

أثناء الفحص، يمكنك الاتصال بالرقم stopScan() أو close() لإيقاف الفحص مؤقتًا أو إنهائه.

Tuner.scan(BLIND_SCAN)

إذا لم يكن لدى TIS قائمة بالترددات وكان بإمكان Vendor HAL البحث عن تردد الواجهة الأمامية التي يحدّدها المستخدم للحصول على مورد الواجهة الأمامية، يُنصح باستخدام Tuner.scan(BLIND_SCAN).

• تستخدم خدمة TIS Tuner.scan(BLIND_SCAN). يمكن تحديد عدد مرات التكرار في FrontendSettings لعدد مرات التكرار عند البدء، ولكن تتجاهل خدمة TIS الإعدادات الأخرى في FrontendSettings.
• تعرض طبقة تجريد الأجهزة (HAL) رسالة LOCKED فحص إذا كانت الإشارة مقفلة.
• تستخدم "خدمة معلومات الضرائب" Frontend.getStatus لجمع المعلومات اللازمة.
• ستتصل خدمة TIS بك Tuner.scan مرة أخرى لمواصلة عملية المسح الضوئي. (سيتم تجاهل FrontendSettings).
• تكرّر خدمة TIS الإجراءات المذكورة أعلاه إلى أن يتم استنفاد جميع الإعدادات المتعلقة بالتكرار. تزيد طبقة تجريد الأجهزة (HAL) من التكرار بدون الحاجة إلى اتّخاذ أي إجراء من نظام معلومات النقل (TIS). تعرض طبقة تجريد الأجهزة (HAL) الرسالة PROGRESS.

تتصل خدمة TIS Tuner.scan(AUTO_SCAN) مرة أخرى إلى أن يتم استنفاد جميع الترددات. تعرض طبقة تجريد الأجهزة END للإشارة إلى انتهاء عملية الفحص.

أثناء الفحص، يمكنك الاتصال بالرقم stopScan() أو close() لإيقاف الفحص مؤقتًا أو إنهائه.

الشكل 9. مخطّط انسيابي لعملية فحص TIS

Android.media.tv.tuner.filter

حزمة الفلتر هي مجموعة من عمليات الفلترة بالإضافة إلى الإعدادات والخيارات وعمليات الرجوع والأحداث. تتضمّن الحزمة العمليات أدناه. راجِع رمز المصدر لنظام التشغيل Android للحصول على القائمة الكاملة بالعمليات.

• configure()
• start()
• stop()
• flush()
• read()

للحصول على القائمة الكاملة، يُرجى الرجوع إلى رمز المصدر لنظام التشغيل Android.

يتم اشتقاق FilterConfiguration من الفئات أدناه. تتضمّن الإعدادات نوع الفلتر الرئيسي، وتحدّد البروتوكول الذي يستخدمه الفلتر لاستخراج البيانات.

• AlpFilterConfiguration
• IpFilterConfiguration
• MmtpFilterConfiguration
• TlvFilterConfiguration
• TsFilterConfiguration

يتم استخلاص الإعدادات من الفئات أدناه. تخصّ هذه الإعدادات النوع الفرعي للفلتر، وتحدّد أنواع البيانات التي يمكن للفلتر استبعادها.

• SectionSettings
• AvSettings
• PesSettings
• RecordSettings
• DownloadSettings

يتم اشتقاق FilterEvent من الفئات أدناه لإعداد تقارير عن الأحداث لأنواع مختلفة من البيانات.

• SectionEvent
• MediaEvent
• PesEvent
• TsRecordEvent
• MmtpRecordEvent
• TemiEvent
• DownloadEvent
• IpPayloadEvent

بدءًا من Android 12 مع الإصدار 1.1 أو الإصدارات الأحدث من Tuner HAL، تتوفّر الأحداث التالية.

• IpCidChangeEvent
• RestartEvent
• ScramblingStatusEvent

تنسيق الأحداث وتنسيق البيانات من الفلتر

مثال على مسار استخدام الفلتر لإنشاء PSI/SI

الشكل 10. مسار إنشاء PSI/SI

1. افتح فلترًا.

   Filter filter = tuner.openFilter(
     Filter.TYPE_TS,
     Filter.SUBTYPE_SECTION,
     /* bufferSize */1000,
     executor,
     filterCallback
   );
   

2. ضبط الفلتر وبدء استخدامه

   Settings settings = SectionSettingsWithTableInfo
       .builder(Filter.TYPE_TS)
       .setTableId(2)
       .setVersion(1)
       .setCrcEnabled(true)
       .setRaw(false)
       .setRepeat(false)
       .build();
     FilterConfiguration config = TsFilterConfiguration
       .builder()
       .setTpid(10)
       .setSettings(settings)
       .build();
     filter.configure(config);
     filter.start();
   

3. معالجة SectionEvent

   FilterCallback filterCallback = new FilterCallback() {
     @Override
     public void onFilterEvent(Filter filter, FilterEvent[] events) {
       for (FilterEvent event : events) {
         if (event instanceof SectionEvent) {
           SectionEvent sectionEvent = (SectionEvent) event;
           int tableId = sectionEvent.getTableId();
           int version = sectionEvent.getVersion();
           int dataLength = sectionEvent.getDataLength();
           int sectionNumber = sectionEvent.getSectionNumber();
           filter.read(buffer, 0, dataLength); }
         }
       }
   };
   

مثال على مسار استخدام MediaEvent من الفلتر

الشكل 11. Flow لاستخدام MediaEvent من الفلتر

1. افتح فلاتر الصوت والفيديو وأعِدّها وابدأها.
2. معالجة MediaEvent
3. استلام MediaEvent
4. أضِفوا المحتوى غير الخطي إلى قائمة المحتوى التالي "codec".
5. إصدار معرّف A/V عند استهلاك البيانات

Android.media.tv.tuner.dvr

توفّر DvrRecorder طُرق التسجيل التالية.

• configure
• attachFilter
• detachFilter
• start
• flush
• stop
• setFileDescriptor
• write

توفّر DvrPlayback هذه الطرق لتشغيل المحتوى.

• configure
• start
• flush
• stop
• setFileDescriptor
• read

يُستخدَم DvrSettings لضبط DvrRecorder وDvrPlayback. يتم استخدام OnPlaybackStatusChangedListener وOnRecordStatusChangedListener للإبلاغ عن حالة مثيل مسجّل فيديو رقمي.

مثال على سير عمل لبدء تسجيل

الشكل 12: سير العمل لبدء تسجيل

1. افتح DvrRecorder واضبطه وابدأ تشغيله.

   DvrRecorder recorder = openDvrRecorder(/* bufferSize */ 1000, executor, listener);
   DvrSettings dvrSettings = DvrSettings
   .builder()
   .setDataFormat(DvrSettings.DATA_FORMAT_TS)
   .setLowThreshold(100)
   .setHighThreshold(900)
   .setPacketSize(188)
   .build();
   recorder.configure(dvrSettings);
   recorder.attachFilter(filter);
   recorder.setFileDescriptor(fd);
   recorder.start();
   

2. تلقّي RecordEvent واسترداد معلومات الفهرس

   FilterCallback filterCallback = new FilterCallback() {
     @Override
     public void onFilterEvent(Filter filter, FilterEvent[] events) {
       for (FilterEvent event : events) {
         if (event instanceof TsRecordEvent) {
           TsRecordEvent recordEvent = (TsRecordEvent) event;
           int tsMask = recordEvent.getTsIndexMask();
           int scMask = recordEvent.getScIndexMask();
           int packetId = recordEvent.getPacketId();
           long dataLength = recordEvent.getDataLength();
           // handle the masks etc. }
         }
       }
   };
   

3. ابدأ OnRecordStatusChangedListener وخزِّن بيانات السجلّ.

     OnRecordStatusChangedListener listener = new OnRecordStatusChangedListener() {
       @Override
       public void onRecordStatusChanged(int status) {
         // a customized way to consume data efficiently by using status as a hint.
         if (status == Filter.STATUS_DATA_READY) {
           recorder.write(size);
         }
       }
     };
   

طبقة تجريد الأجهزة الخاصة بأداة استقبال التلفزيون

تتّبع طبقة HAL الخاصة ببرنامج Tuner لغة تعريف واجهة HIDL وتحدّد الواجهة بين إطار العمل وأجهزة المورّد. يستخدم المورّدون الواجهة لتنفيذ Tuner HAL، ويستخدمها إطار العمل للتواصل مع عملية تنفيذ Tuner HAL.

الوحدات

Tuner HAL 1.0

الإصدار 1.1 من طبقة تجريد الأجهزة الخاصة بأداة استقبال التلفزيون (مستمد من الإصدار 1.0)

الشكل 13. مخطّط تفاعلات وحدات Tuner HAL

ربط الفلاتر

تتيح طبقة تجريد الأجهزة (HAL) الخاصة ببرنامج Tuner ربط الفلاتر ببعضها، ما يتيح ربط الفلاتر بفلاتر أخرى لإنشاء طبقات متعددة. تخضع الفلاتر للقواعد التالية.

• يتم ربط الفلاتر كشجرة، ولا يُسمح بالمسار المغلق.
• عقدة الجذر هي demux.
• تعمل الفلاتر بشكل مستقل.
• تبدأ جميع الفلاتر في تلقّي البيانات.
• يتم إفراغ ربط الفلاتر عند آخر فلتر.

يوضّح كلّ من مجموعة الرموز أدناه والشكل 14 مثالاً على فلترة طبقات متعدّدة.

demuxCaps = ITuner.getDemuxCap;
If (demuxCaps[IP][MMTP] == true) {
        ipFilter = ITuner.openFilter(<IP, ..>)
        mmtpFilter1 = ITuner.openFilter(<MMTP ..>)
        mmtpFilter2 = ITuner.openFilter(<MMTP ..>)
        mmtpFilter1.setDataSource(<ipFilter>)
        mmtpFilter2.setDataSource(<ipFilter>)
}

الشكل 14. مخطّط انسيابي لربط الفلاتر بطبقات متعددة

Tuner Resource Manager

قبل توفّر واجهة برمجة التطبيقات Tuner Resource Manager (TRM)، كان التبديل بين تطبيقَين يتطلّب استخدام جهاز Tuner نفسه. استخدم إطار عمل إدخال التلفزيون (TIF) آلية "الفوز بالاستحواذ أولاً"، ما يعني أنّ التطبيق الذي يحصل على المورد أولاً يحتفظ به. ومع ذلك، قد لا تكون هذه الآلية مناسبة لبعض حالات الاستخدام المعقّدة.

تعمل "إدارة الموارد التلفزيونية" كخدمة تابعة لنظام التشغيل لإدارة موارد الأجهزة الخاصة بـ "الموالف" (Tuner) وTVInput وCAS للتطبيقات. تستخدِم ميزة "إدارة الموارد الحرارية" آلية "الفوز في المقدّمة" التي تحتسب أولوية التطبيق استنادًا إلى حالة التطبيق في المقدّمة أو الخلفية ونوع حالة الاستخدام. يمنح مدير الموارد أو يبطلها استنادًا إلى الأولوية. تتيح إدارة الموارد في ATV بشكل مركزي للبث المباشر وخدمات البث عبر الإنترنت (OTT) وتسجيل الفيديو الرقمي (DVR).

واجهة TRM

تعرض واجهة TRM واجهات AIDL في ITunerResourceManager.aidl لإطار عمل Tuner وMediaCas وTvInputHardwareManager لتسجيل الموارد أو طلبها أو تحريرها.

في ما يلي واجهات إدارة العملاء.

• registerClientProfile(in ResourceClientProfile profile, IResourcesReclaimListener listener, out int[] clientId)
• unregisterClientProfile(in int clientId)

في ما يلي الواجهات التي يمكن من خلالها طلب الموارد وتحريرها.

• requestFrontend(TunerFrontendRequest request, int[] frontendHandle) / releaseFrontend
• requestDemux(TunerDemuxRequest request, int[] demuxHandle) / releaseDemux
• requestDescrambler(TunerDescramblerRequest request, int[] descramblerHandle) / releaseDescrambler
• requestCasSession(CasSessionRequest request, int[] casSessionHandle) / releaseCasSession
• requestLnb(TunerLnbRequest request, int[] lnbHandle) / releaseLnb

في ما يلي قائمة بفئات العملاء والطلبات.

• ResourceClientProfile
• ResourcesReclaimListener
• TunerFrontendRequest
• TunerDemuxRequest
• TunerDescramblerRequest
• CasSessionRequest
• TunerLnbRequest

أولوية العميل

تحسب خدمة TRM أولوية العميل باستخدام مَعلمات من ملف تعريف العميل وقيمة الأولوية من ملف الإعداد. يمكن أيضًا تعديل الأولوية باستخدام قيمة أولوية عشوائية من العميل.

المَعلمات في الملف الشخصي للعميل

يستردّ TRM معرّف العملية من mTvInputSessionId لتحديد ما إذا كان التطبيق يعمل في المقدّمة أو في الخلفية. لإنشاء mTvInputSessionId أو TvInputService.onCreateSession أو TvInputService.onCreateRecordingSession، يبدأ TvInputService.onCreateSession جلسة TIS.

يشير mUseCase إلى حالة استخدام الجلسة. في ما يلي حالات الاستخدام المحدّدة مسبقًا.

TvInputService.PriorityHintUseCaseType  {
  PRIORITY_HINT_USE_CASE_TYPE_PLAYBACK
  PRIORITY_HINT_USE_CASE_TYPE_LIVE
  PRIORITY_HINT_USE_CASE_TYPE_RECORD,
  PRIORITY_HINT_USE_CASE_TYPE_SCAN,
  PRIORITY_HINT_USE_CASE_TYPE_BACKGROUND
}

ملف الإعداد

ملف الإعدادات التلقائية

يوفر ملف الإعداد التلقائي أدناه قيم الأولوية لحالات الاستخدام المحددة مسبقًا. يمكن للمستخدمين تغيير القيم باستخدام ملف إعداد مخصّص.

ملف إعداد مخصّص

يمكن للمورّدين تخصيص ملف الإعدادات /vendor/etc/tunerResourceManagerUseCaseConfig.xml. يُستخدَم هذا الملف لإضافة أنواع حالات الاستخدام أو إزالتها أو تعديلها وقيم أولوية حالات الاستخدام. يمكن أن يستخدم الملف المعدَّل platform/hardware/interfaces/tv/tuner/1.0/config/tunerResourceManagerUseCaseConfigSample.xml كنموذج.

على سبيل المثال، حالة استخدام بائع جديد هي VENDOR_USE_CASE__[A-Z0-9]+, [0 - 1000]. يجب أن يكون التنسيق على النحو التالي: platform/hardware/interfaces/tv/tuner/1.0/config/tunerResourceManagerUseCaseConfig.xsd.

قيمة الأولوية العشوائية وقيمة nice

توفّر TRM updateClientPriority للعميل من أجل تعديل قيمة الأولوية والقيمة اللطيفة العشوائية. تستبدل قيمة الأولوية العشوائية قيمة الأولوية المحسوبة من نوع حالة الاستخدام ومعرّف الجلسة.

تشير قيمة nice إلى مدى تساهل سلوك العميل عندما يتعارض مع عميل آخر. تؤدي قيمة nice إلى خفض قيمة أولوية العميل قبل مقارنتها بأولوية العميل الصعب.

آلية الاسترداد

يوضِّح المخطّط البياني أدناه كيفية استرداد الموارد وتعيينها عند حدوث تعارض في الموارد.

الشكل 15. مخطّط لآلية استرداد الموارد في حال حدوث تعارض بين موارد Tuner