เอกสารนี้มีไว้เพื่อช่วยผู้ผลิตอุปกรณ์ดั้งเดิม (OEM) ในการติดตั้งใช้งานการรองรับตัวจัดการทรัพยากรสื่อของ Android และ API ที่เกี่ยวข้องอย่างเหมาะสม
อินสแตนซ์ของตัวแปลงรหัสพร้อมกันสูงสุด
อินเทอร์เฟซ CodecCapabilities.getMaxSupportedInstances
จะแสดงจำนวนสูงสุดของอินสแตนซ์ตัวแปลงรหัสพร้อมกันที่รองรับ
การทดสอบ CTS
testGetMaxSupportedInstances(android.media.cts.MediaCodecCapabilitiesTest)
ใช้เพื่อบังคับใช้การตั้งค่าสูงสุดที่เหมาะสมใน
/etc/media_codecs.xml
มีตัวอย่างดังต่อไปนี้
... <MediaCodecs> ... <Encoders> <MediaCodec name="OMX.<vendor>.video.encoder.avc" type="video/avc" > ... <Limit name="concurrent-instances" max="13" /> </MediaCodec> ... </Encoders> ... </MediaCodecs>
OEM สามารถใช้การทดสอบนี้เพื่อสร้างขีดจำกัดพร้อมกันที่ผ่านการทดสอบ โดยทำดังนี้
- เรียกใช้การทดสอบก่อนโดยใช้ cts-tradefed
- ประเมินข้อความแสดงข้อผิดพลาดที่เกิดขึ้น มีตัวอย่างดังต่อไปนี้
There was 1 failure: 1) testGetMaxSupportedInstances(android.media.cts.MediaCodecCapabilitiesTest) junit.framework.AssertionFailedError: In order to pass the test, please publish following codecs' concurrent instances limit in /etc/media_codecs.xml: <MediaCodec name="OMX.<vendor>.video.encoder.mpeg4" type="video/mp4v-es" > <Limit name="concurrent-instances" max="13" /> </MediaCodec> <MediaCodec name="OMX.<vendor>.video.encoder.h263" type="video/3gpp" > <Limit name="concurrent-instances" max="13" /> </MediaCodec> <MediaCodec name="OMX.<vendor>.video.encoder.avc" type="video/avc" > <Limit name="concurrent-instances" max="13" /> </MediaCodec> <MediaCodec name="OMX.<vendor>.video.encoder.vp8" type="video/x-vnd.on2.vp8" > <Limit name="concurrent-instances" max="13" /> </MediaCodec> <MediaCodec name="OMX.<vendor>.video.decoder.avc" type="video/avc" > <Limit name="concurrent-instances" max="13" /> </MediaCodec> <MediaCodec name="OMX.<vendor>.video.decoder.avc.secure" type="video/avc" > <Limit name="concurrent-instances" max="4" /> </MediaCodec> <MediaCodec name="OMX.<vendor>.video.decoder.mpeg4" type="video/mp4v-es" > <Limit name="concurrent-instances" max="12" /> </MediaCodec> <MediaCodec name="OMX.<vendor>.video.decoder.h263" type="video/3gpp" > <Limit name="concurrent-instances" max="12" /> </MediaCodec> <MediaCodec name="OMX.<vendor>.video.decoder.vp8" type="video/x-vnd.on2.vp8" > <Limit name="concurrent-instances" max="12" /> </MediaCodec>
- เพิ่มบรรทัด
concurrent-instances
ที่แนะนำในข้อความ การทดสอบล้มเหลวลงในไฟล์/etc/media_codecs.xml
- เรียกใช้การทดสอบอีกครั้งเพื่อยืนยันว่าสำเร็จ
อัตราเฟรมที่ทำได้สำหรับตัวแปลงรหัสวิดีโอ
VideoCapabilities.getAchievableFrameRatesFor
อินเทอร์เฟซ
จะแสดงช่วงของอัตราเฟรมวิดีโอที่ทำได้สำหรับขนาดวิดีโอ OEM ต้องระบุข้อมูลนี้สำหรับอุปกรณ์แต่ละเครื่องผ่านไฟล์ XML ที่วางไว้ที่
/etc/media_codecs_performance.xml
การตั้งค่าเหล่านี้ได้รับการทดสอบโดย
การทดสอบ com.android.cts.videoperf.VideoEncoderDecoderTest
และ
android.media.cts.VideoDecoderPerfTest
CTS
OEM สามารถใช้การทดสอบ CTS เพื่อสร้างไฟล์ XML ที่ผ่านการทดสอบ โดยทำดังนี้
- เรียกใช้การทดสอบก่อนโดยใช้ cts-tradefed เนื่องจากประสิทธิภาพของ Android มีความผันแปร เราจึงขอแนะนำให้ทำการทดสอบหลายครั้งเพื่อให้ได้ค่าต่ำสุดและสูงสุดที่แม่นยำยิ่งขึ้น
- ใช้สคริปต์ get_achievable_rates.py ที่ให้ไว้เพื่อสร้างไฟล์ XML
- วางไฟล์ XML ที่
/etc/media_codecs_performance.xml
โดยปกติแล้วจะทำโดยการวางไฟล์ XML ในโปรเจ็กต์อุปกรณ์ (device/<vendor>/<product>) และเพิ่มบรรทัดPRODUCT_COPY_FILES
ไปยังdevice.mk
ดังนี้PRODUCT_COPY_FILES += \ ... device/moto/shamu/media_codecs.xml:system/etc/media_codecs.xml \ + device/moto/shamu/media_codecs_performance.xml:system/etc/media_codecs_performance.xml
- เรียกใช้การทดสอบประสิทธิภาพอีกครั้งเพื่อยืนยันความสำเร็จ
การทำงานร่วมกันของตัวแปลงรหัสที่ปลอดภัยและตัวแปลงรหัสที่ไม่ปลอดภัย
- supports-secure-with-non-secure-codec —
หากอินสแตนซ์ของตัวแปลงรหัสที่ปลอดภัยและอินสแตนซ์ของตัวแปลงรหัสที่ไม่ปลอดภัยไม่สามารถ
อยู่ร่วมกันได้ในเวลาเดียวกัน ควรระบุเป็นการตั้งค่าส่วนกลางในไฟล์
media_codecs.xml
<MediaCodecs> <Settings> <Setting name="supports-secure-with-non-secure-codec" value="false" /> </Settings> <Encoders> …
- supports-multiple-secure-codecs —
หากไม่รองรับการทำงานร่วมกันของอินสแตนซ์ตัวแปลงรหัสที่ปลอดภัยหลายรายการ ควร
ระบุเป็นการตั้งค่าส่วนกลางในไฟล์
media_codecs.xml
<MediaCodecs> <Settings> <Setting name="supports-multiple-secure-codecs" value="false" /> </Settings> <Encoders> …
- โปรดทราบว่าการตั้งค่าทั้ง 2 รายการเป็นจริงโดยค่าเริ่มต้น ซึ่งหมายความว่าหากมีการรองรับ
ก็ไม่จำเป็นต้องเพิ่มบรรทัดการตั้งค่าลงใน
media_codecs.xml
ResourceManagerTest
การทดสอบ CTS อาจล้มเหลวหากไม่ได้ตั้งค่า 2 รายการนี้ อย่างถูกต้อง