이 페이지는 Cloud Translation API를 통해 번역되었습니다.

ROI 구현을 위한 OEM 안내

Android 15에서는 관심 지역 (RoI) 사용자 구성을 Android 동영상에 통합 인코딩 프레임워크입니다. 이 기능은 사용자 구성을 동영상 인코더에 통합하고 분석하는 공개 API를 제공하여 RoI의 압축 품질을 개선합니다.

구현

SoC 공급업체 및 OEM은 FEATURE_Roi 플래그를 사용하여 동영상 인코딩의 RoI 지원을 제어할 수 있습니다. FEATURE_Roi를 사용 설정하지 않으면 동영상 인코더 동작이 변경되지 않습니다.

동영상 프레임워크 변경사항

이 섹션에서는 이를 구현하는 데 필요한 동영상 프레임워크의 변경사항을 자세히 설명합니다. 기능을 사용할 수 있습니다.

Codec2의 키

Android 15에서는 양자화 매개변수 맵이 (QP_map) 및 직사각형 구성 (rect)이 RoI로 정의됨 구성 유형을 사용합니다 또한 이러한 새 유형을 지원하기 위해 Codec2(C2)에 두 개의 키가 도입되었습니다. 두 키 사용은 공개 API와 동일합니다. 인코더의 프레임 루프 내에서 구성은 동적으로 조정됨 입력 버퍼가 큐에 추가되기 전에, 다음과 같습니다.

고정 시나리오에서 현재 프레임에 RoI 구성이 제공되지 않으면 인코더는 이전 프레임과 동일한 구성을 사용합니다.
동적 시나리오에서는 RoI 구성 유형이 동적으로 변경될 수 있습니다.

C2의 새로운 키는 다음 섹션에서 설명합니다.

kParamIndexQpOffsetMapBuffer

kParamIndexQpOffsetMapBuffer 키는 프레임의 qp-offset 맵에 신호를 보냅니다. 값은 setParameters의 입력 매개변수 PARAMETER_KEY_QP_OFFSET_MAP를 사용하여 설정됩니다.

kParamIndexQpOffsetMapBuffer는 다음에서 바이트 배열입니다. C2InfoBuffer, 다음 속성을 사용합니다.

길이: 한 프레임의 16x16 블록 수
값: 배열의 각 값은 지역 내 16x16 블록의 QP 오프셋입니다. -51~51. 타겟 최대 코딩 단위 (LCU)의 QP는 인코더 속도 제어와 오프셋의 조합입니다. 계산된 결과가 0~51 범위를 초과하면 값이 0~51로 잘립니다.
- 0: QP 오프셋이 없는 경우 QP는 원래 속도 컨트롤에 의해 결정됩니다.
- 0이 아니면 QP는 원래 속도 제어에 오프셋을 더한 값입니다.
- 음수인 경우: 대상 LCU에서 동영상 화질이 향상됩니다.
- 양성인 경우: 타겟 LCU에서 동영상 품질이 저하됩니다.
사용법: 사용자는 이 키를 16x16 블록으로 구성해야 합니다. 인코더는 LCU의 16x16 블록 값을 평균화하여 구성을 실제 LCU 크기로 조정합니다.

C2_PARAMKEY_QP_OFFSET_RECTS

C2_PARAMKEY_QP_OFFSET_RECTS 키(coding.qp-offset-rects로 설정됨)는 RoI를 QpOffset-Rects로 설정합니다. 값은 setParameters의 입력 매개변수 PARAMETER_KEY_QP_OFFSET_RECTS를 사용하여 설정됩니다.

이 키를 지원하려면 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는 LCU 경계에 맞게 확장됩니다. 이 값은 각 픽셀의 왼쪽 상단 모서리에서 ((0,0), (16, 16))이 완전한 16x16 블록이 필요합니다.
qpOffset: 배열의 각 값은 타겟 rect 영역의 QP 오프셋을 나타냅니다. 정의와 사용법은 kParamIndexQpOffsetMapBuffer 값과 동일합니다.

매핑 알고리즘

다음 표에서는 공개 키에서 동영상으로의 매핑을 보여줍니다. 프레임워크:

공개 키 또는 API	동영상 프레임워크의 매핑
`PARAMETER_KEY_QP_OFFSET_MAP`	값은 `kParamIndexQpOffsetMapBuffer`에 `C2InfoBuffer` 인스턴스로 전달됩니다.
`PARAMETER_KEY_QP_OFFSET_RECTS`	값이 `String`에서 다음으로 변환됩니다. `Struct C2QpOffsetRectStruct` 및 전달 대상 `C2_PARAMKEY_QP_OFFSET_RECTS`입니다.

오류 처리

OEM 구현은 다음 오류 사례를 처리해야 합니다.

오류 사례 예 취급

공급업체 키와 표준화된 키는 모두 RoI를 사용 설정하는 데 사용됩니다. 사용자가 setFeatureEnabled(FEATURE_ROI) 그리고 공급업체 키를 사용하여 ROI를 사용 설정합니다. RoI를 사용 설정해야 합니다.

QP 오프셋이 범위 내에 있지만 SoC 공급업체에서 지원하지 않습니다. 사용자가 QP 오프셋을 12로 설정하지만 SoC는 최대 10의 QP 오프셋만 지원합니다. 지원되는 QP 오프셋 범위는 최선을 다해 유지합니다. 값은 SoC의 지원 범위에 제한됩니다.

여러 RoI 구성(표준화된 키 또는 공급업체별 키)이 단일 프레임으로 설정됩니다.

사용자가 프레임 1에 표준화된 키와 공급업체 키를 모두 사용합니다.

오류 사례	예	취급
공급업체 키와 표준화된 키는 모두 RoI를 사용 설정하는 데 사용됩니다.	사용자가 `setFeatureEnabled(FEATURE_ROI)` 그리고 공급업체 키를 사용하여 ROI를 사용 설정합니다.	RoI를 사용 설정해야 합니다.
QP 오프셋이 범위 내에 있지만 SoC 공급업체에서 지원하지 않습니다.	사용자가 QP 오프셋을 12로 설정하지만 SoC는 최대 10의 QP 오프셋만 지원합니다.	지원되는 QP 오프셋 범위는 최선을 다해 유지합니다. 값은 SoC의 지원 범위에 제한됩니다.
여러 RoI 구성(표준화된 키 또는 공급업체별 키)이 단일 프레임으로 설정됩니다.	사용자가 프레임 1에 표준화된 키와 공급업체 키를 모두 사용합니다.	가능한 경우 프레임워크는 첫 번째 표준화된 `rect` 구성, 첫 번째 표준화된 `QP_map` 구성 또는 둘 다를 유지합니다. 각 카테고리에서 프레임워크는 SoC에 표준화된 구성을 하나만 전송하며, 표준화된 구성을 사용할 수 있는 경우 SoC 구현은 공급업체 구성을 무시해야 합니다. 만약 여러 구성이 SoC로 전송되기 때문에 SoC 공급업체는 하나의 RoI 구성만 사용하고 나머지 구성은 무시합니다. 구성은 다음 우선순위 순으로 유지됩니다. 표준화된 `rect` 표준화된 `QP_map` 공급업체 `rect` 공급업체 `QP_map`

가능한 경우 프레임워크는 첫 번째 표준화된 rect 구성, 첫 번째 표준화된 QP_map 구성 또는 둘 다를 유지합니다. 각 카테고리에서 프레임워크는 SoC에 표준화된 구성을 하나만 전송하며, 표준화된 구성을 사용할 수 있는 경우 SoC 구현은 공급업체 구성을 무시해야 합니다. 만약 여러 구성이 SoC로 전송되기 때문에 SoC 공급업체는 하나의 RoI 구성만 사용하고 나머지 구성은 무시합니다.

구성은 다음 우선순위 순으로 유지됩니다.

표준화된 rect
표준화된 QP_map
공급업체 rect
공급업체 QP_map