इस दस्तावेज़ का उद्देश्य सिस्टम ऑन चिप विक्रेताओं (एसओसी) को एंड्रॉइड मीडिया संसाधन प्रबंधक के लिए प्राथमिकता, ऑपरेटिंग दर और आवश्यक हुक के लिए समर्थन को ठीक से लागू करने में मदद करना है।
OMX_Errorअपर्याप्तसंसाधन
यदि विफलता अपर्याप्त संसाधन के कारण होती है, तो कोडेक घटक को GetHandle , Init , UseBuffer , AllocateBuffer या एक राज्य संक्रमण पर OMX_ErrorInsufficientResources लौटाना चाहिए। त्रुटि कोड का उपयोग मीडिया संसाधन प्रबंधक द्वारा अन्य निचली प्राथमिकता वाली प्रक्रिया से संभावित रूप से मीडिया संसाधन को हटाने के संकेतक के रूप में किया जाएगा।
प्रत्येक कोडेक को बार-बार आवंटित करने, कॉन्फ़िगर करने और प्रारंभ करने के लिए एक एंड्रॉइड संगतता परीक्षण सूट (सीटीएस) परीक्षण मौजूद है जब तक कि catching OMX_ErrorInsufficientResources ।
OMX_IndexConfigPriority
यह कॉन्फ़िगरेशन एप्लिकेशन को वांछित कोडेक प्राथमिकता का वर्णन करने देता है।
संबद्ध मान एक पूर्णांक है. उच्च मूल्य का मतलब कम प्राथमिकता है। वर्तमान में, केवल दो स्तर समर्थित हैं:
- 0: रीयलटाइम प्राथमिकता - जिसका अर्थ है कि कोडेक रीयलटाइम पर दिए गए प्रदर्शन कॉन्फ़िगरेशन (उदाहरण फ़्रेमरेट) का समर्थन करेगा। इसका उपयोग केवल मीडिया प्लेबैक, कैप्चर और संभवतः वास्तविक समय संचार परिदृश्यों द्वारा किया जाएगा यदि सर्वोत्तम प्रयास प्रदर्शन उपयुक्त नहीं है।
- 1: गैर-वास्तविक समय प्राथमिकता (सर्वोत्तम प्रयास)। यह व्यतिक्रम मूल्य है।
विक्रेता को एप्लिकेशन की वास्तविक समय आवश्यकताओं को समझने के लिए कोडेक कॉन्फ़िगरेशन और संसाधन नियोजन में उपयोग किए जाने वाले संकेत के रूप में इसका उपयोग करने का सुझाव दिया गया है।
जब तक इसे 0 पर कॉन्फ़िगर न किया जाए तब तक रीयलटाइम प्राथमिकता न मानें।
OMX_IndexConfigOperatingRate
यह कॉन्फ़िगरेशन एप्लिकेशन को वीडियो के लिए ऑपरेटिंग फ़्रेम दर या ऑडियो के लिए नमूना दर का वर्णन करने देता है जिस पर कोडेक को संचालित करने की आवश्यकता होगी।
इसका उपयोग हाई-स्पीड/स्लो-मोशन वीडियो कैप्चर जैसे मामलों के लिए किया जाता है, जहां वीडियो एनकोडर प्रारूप में लक्ष्य प्लेबैक दर (जैसे 30fps) होती है, लेकिन घटक को उच्च ऑपरेटिंग कैप्चर दर (जैसे 240fps) को संभालने में सक्षम होना चाहिए।
इस दर का उपयोग संसाधन नियोजन और परिचालन बिंदु निर्धारित करने के लिए किया जाना चाहिए।