आरओआई लागू करने के लिए OEM के लिए दिशा-निर्देश

Android 15 में, दिलचस्पी वाले इलाके (RoI) से जुड़ी उपयोगकर्ता की सेटिंग को Android वीडियो एनकोडिंग फ़्रेमवर्क में इंटिग्रेट करने के लिए, एक स्टैंडर्ड प्रोसेस शुरू की गई है. इस सुविधा की मदद से, RoI के लिए बेहतर कंप्रेशन क्वालिटी मिलती है. इसके लिए, सार्वजनिक एपीआई उपलब्ध कराए जाते हैं. इनकी मदद से, वीडियो एनकोडर में उपयोगकर्ता की सेटिंग को इंटिग्रेट और उनका विश्लेषण किया जा सकता है.

लागू करना

SoC वेंडर और ओईएम, FEATURE_Roi फ़्लैग की मदद से, वीडियो एनकोडिंग के लिए RoI की सुविधा को कंट्रोल कर सकते हैं. अगर FEATURE_Roi की सुविधा चालू नहीं है, तो वीडियो एनकोडर के व्यवहार में कोई बदलाव नहीं होता.

वीडियो फ़्रेमवर्क में बदलाव

इस सेक्शन में, इस सुविधा को लागू करने के लिए वीडियो फ़्रेमवर्क में किए जाने वाले बदलावों के बारे में बताया गया है.

Codec2 में कुंजियां

Android 15 में, क्वॉन्टाइज़ेशन पैरामीटर मैप (QP_map) और आयताकार कॉन्फ़िगरेशन (rect) को RoI कॉन्फ़िगरेशन टाइप के तौर पर तय किया गया है. इसके अलावा, इन नए टाइप के लिए सहायता उपलब्ध कराने के लिए, Codec2 (C2) में दो कुंजियां जोड़ी गई हैं. दोनों कुंजियों का इस्तेमाल, सार्वजनिक एपीआई की तरह ही किया जाता है. एनकोडर के फ़्रेम लूप में, इनपुट बफ़र को क्यू में जोड़ने से पहले, रनिंग स्टेज के दौरान कॉन्फ़िगरेशन को डाइनैमिक तरीके से अडजस्ट किया जाता है. इसके बारे में यहां बताया गया है:

• स्टिक वाले मामले में, अगर मौजूदा फ़्रेम के लिए RoI कॉन्फ़िगरेशन उपलब्ध नहीं कराया जाता है, तो एनकोडर पिछले फ़्रेम के जैसा ही कॉन्फ़िगरेशन इस्तेमाल करता है.

• डाइनैमिक वाले मामले में, RoI कॉन्फ़िगरेशन टाइप को डाइनैमिक तरीके से बदला जा सकता है.

C2 में मौजूद नई कुंजियों के बारे में, यहां दिए गए सेक्शन में बताया गया है.

kParamIndexQpOffsetMapBuffer

The kParamIndexQpOffsetMapBuffer कुंजी, किसी फ़्रेम के लिए qp-offset मैप का सिग्नल देती है. इसकी वैल्यू, setParameters से इनपुट पैरामीटर PARAMETER_KEY_QP_OFFSET_MAP का इस्तेमाल करके सेट की जाती है.

kParamIndexQpOffsetMapBuffer एक बाइट कलेक्शन होता है C2InfoBuffer, इसमें ये एट्रिब्यूट होते हैं:

• लंबाई: एक फ़्रेम में 16x16 ब्लॉक की संख्या.

• वैल्यू: कलेक्शन की हर वैल्यू, -51~51 के बीच के इलाके में, 16x16 ब्लॉक का QP ऑफ़सेट होती है. एनकोडर रेट कंट्रोल के साथ-साथ ऑफ़सेट की मदद से, टारगेट किए गए सबसे बड़े कोडिंग यूनिट (एलसीयू) का QP कैलकुलेट किया जाता है. अगर कैलकुलेट किया गया नतीजा, 0~51 के बीच के इलाके से बाहर जाता है, तो वैल्यू को 0~51 के बीच में काट दिया जाता है.

  • अगर 0 है, तो कोई QP ऑफ़सेट नहीं होता. QP, ओरिजनल रेट कंट्रोल से तय होता है.
  • अगर शून्य नहीं है, तो QP, ओरिजनल रेट कंट्रोल के साथ-साथ ऑफ़सेट भी होता है.
  • अगर नेगेटिव है, तो टारगेट किए गए एलसीयू में वीडियो की क्वालिटी बेहतर होती है.
  • अगर पॉज़िटिव है, तो टारगेट किए गए एलसीयू में वीडियो की क्वालिटी कम हो जाती है.

• इस्तेमाल: उपयोगकर्ता को इस कुंजी को 16x16 ब्लॉक के तौर पर कॉन्फ़िगर करना होगा. एनकोडर, एलसीयू में मौजूद 16x16 ब्लॉक की वैल्यू का औसत निकालकर, कॉन्फ़िगरेशन को असली एलसीयू साइज़ के हिसाब से अडजस्ट करता है.

C2_PARAMKEY_QP_OFFSET_RECTS

The C2_PARAMKEY_QP_OFFSET_RECTS कुंजी (जिसे coding.qp-offset-rects पर सेट किया जाता है), RoI को QpOffset-Rectsके तौर पर सेट करती है. इसकी वैल्यू, PARAMETER_KEY_QP_OFFSET_RECTS से इनपुट पैरामीटर setParameters का इस्तेमाल करके सेट की जाती है.

इस कुंजी के लिए सहायता उपलब्ध कराने के लिए, यह स्ट्रक्चर C2QpOffsetRectStruct जोड़ा गया है:

struct C2QpOffsetRectStruct : C2Rect {
  int32_t qpOffset;

  DEFINE_AND_DESCRIBE_C2STRUCT(QpOffsetRect)
  C2FIELD(width, "width")
  C2FIELD(height, "height")
  C2FIELD(left, "left")
  C2FIELD(top, "top")
  C2FIELD(qpOffset, "qp-offset")
}

यहां:

• top और left: आयताकार आकार में, RoI के कोऑर्डिनेट. RoI को एलसीयू की सीमाओं के साथ अलाइन करने के लिए, स्ट्रेच किया जाता है. वैल्यू, हर पिक्सल के टॉप-लेफ़्ट कॉर्नर को दिखाती है. जैसे, ((0,0), (16, 16)) से 16x16 का पूरा ब्लॉक तय होता है.

• qpOffset: कलेक्शन की हर वैल्यू, टारगेट किए गए rect इलाके के QP ऑफ़सेट को दिखाती है. इसकी परिभाषा और इस्तेमाल, kParamIndexQpOffsetMapBuffer वैल्यू के जैसे ही होते हैं.

मैपिंग एल्गोरिद्म

यहां दी गई टेबल में, सार्वजनिक कुंजियों से वीडियो फ़्रेमवर्क में मैपिंग के बारे में बताया गया है:

गड़बड़ी ठीक करना

ओईएम को लागू करने के दौरान, गड़बड़ी के इन मामलों को ठीक करना होगा: