ضبط إعدادات العرض

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

مطابقة عدد اللقطات في الثانية للمحتوى

عندما لا يتطابق عدد اللقطات في الثانية للفيديو مع معدّل تحديث الشاشة، قد يواجه المستخدمون تشوّهات غير سارة في الحركة ناتجة عن تحويل عدد اللقطات في الثانية. ويظهر ذلك بشكل خاص أثناء لقطات التحريك البطيء للكاميرا. لهذا السبب، من المهم استخدام واجهة برمجة التطبيقات SurfaceControl.Transaction.setFrameRate() لإعلام إطار العمل بمعدّل عرض المحتوى وتحديد ما إذا كان محتوى الفيديو مؤهلاً لتبديل معدّل عرض غير سلس.

لمزيد من المعلومات، يُرجى الاطّلاع على دليل معدّل عرض اللقطات.

مطابقة ملفات تعريف الصور المفضّلة

تتيح واجهة برمجة التطبيقات MediaQuality في Android 16 للمطوّرين التحكّم في ملفات تعريف الصور.

تشمل بعض الأمثلة على السيناريوهات ما يلي:

• بالنسبة إلى الأفلام والمسلسلات التلفزيونية التي تم إعدادها بنطاق ديناميكي أوسع، قد يطلب المطوّرون تفعيل وضع "صانع الأفلام" لعرض المحتوى بدقة كما أراد صانعه أن يظهر. يبرز ملف تعريف السينما الذي يتميّز بدقة أكبر في الألوان التفاصيل الدقيقة في الظلال بدلاً من زيادة السطوع.
• يمكن أن تستفيد الفعاليات الرياضية المباشرة، التي يتم إعدادها غالبًا بنطاق ديناميكي ضيق ويتم مشاهدتها في ضوء النهار، من ملف تعريف يمنح الأولوية للسطوع على دقة الألوان.
• يمكن لمطوّري الألعاب طلب ملف شخصي بوقت استجابة قصير مع الحد الأدنى من معالجة الصور، ما يتيح للاعبين الحصول على أفضل أداء من شاشاتهم.

اختيار ملف تعريف صورة نظام

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

يوضّح المقتطف التالي كيفية استخدام getAvailablePictureProfiles() للاستعلام عن جميع إعدادات الصور المتوافقة وتطبيق إعدادات رياضية:

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.BAKLAVA) {
    val mediaQualityManager: MediaQualityManager =
        context.getSystemService(MediaQualityManager::class.java)
    val profiles = mediaQualityManager.getAvailablePictureProfiles(null)
    for (profile in profiles) {
        // If we have a system sports profile, apply it to our media codec
        if (profile.profileType == PictureProfile.TYPE_SYSTEM
            && profile.name == NAME_SPORTS
        ) {
            val bundle = Bundle().apply { 
                putParcelable(MediaFormat.KEY_PICTURE_PROFILE_INSTANCE, profile)
            }
            mediaCodec.setParameters(bundle)
        }
    }
}

للحصول على ملف شخصي معيّن بالاسم، استخدِم getPictureProfile():

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.BAKLAVA) {
    val profile = mediaQualityManager.getPictureProfile(
        PictureProfile.TYPE_SYSTEM, NAME_SPORTS, null)
}

إذا لم تكن بحاجة إلى الاستعلام عمّا إذا كان الملف الشخصي متاحًا، يمكن توفير الملفات الشخصية مباشرةً من خلال معرّفها إلى MediaCodec باستخدام MediaFormat.KEY_PICTURE_PROFILE_INSTANCE.

على الرغم من أنّ الملفات الشخصية المتوافقة قد تختلف حسب الجهاز، يمكنك مطابقة الملفات الشخصية مع معرّفات ملفات النظام الشخصية المعروفة التالية:

const val NAME_STANDARD: String = "standard"
const val NAME_VIVID: String = "vivid"
const val NAME_SPORTS: String = "sports"
const val NAME_GAME: String = "game"
const val NAME_MOVIE: String = "movie"
const val NAME_ENERGY_SAVING: String = "energy_saving"
const val NAME_USER: String = "user"