문제해결

데모 앱에서 로컬 파일에 액세스할 수 없는 이유는 무엇인가요?

Android 11(API 수준 30)의 범위 지정 저장소 적용은 파일 시스템 직접 액세스를 차단합니다. 개발 중에 수동으로 테스트하는 경우 데모 앱 매니페스트에 외부 저장소 관리 권한을 추가하여 로컬 파일에 액세스할 수 있습니다.

<uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE"/>

그런 다음 adb를 통해 권한을 부여합니다.

adb shell appops set --uid androidx.media3.demo.transformer \
    MANAGE_EXTERNAL_STORAGE allow

특정 기기에서 내보내기가 실패하는 이유는 무엇인가요?

Media3 Issue Tracker에서 문제를 재현하기에 충분한 정보를 포함하여 문제를 신고하세요. 기기별 문제에 관한 해결 방법을 라이브러리에 추가하여 시간이 지남에 따라 호환성을 개선할 수 있습니다.

Transformer는 원격 미디어 변환 (또는 기록)을 지원하나요?

Transformer는 MP4와 같은 미디어 파일 컨테이너를 포함하여 원격 프로그레시브 스트림을 지원합니다.

네트워크 상태가 매우 좋지 않은 경우 원격 미디어를 너무 오래 버퍼링하면 파이프라인이 중단되었음을 식별하기 위한 Muxer에서 검사가 트리거되기 때문에 내보내기가 실패할 수 있습니다. Transformer.Builder에서 maxDelayBetweenMuxerSamplesMs를 설정하여 기본 동작을 재정의할 수 있습니다.

Kotlin

Transformer.Builder(context)
    .setMaxDelayBetweenMuxerSamplesMs(C.TIME_UNSET)
    .build()

Java

new Transformer.Builder(context)
    .setMaxDelayBetweenMuxerSamplesMs(C.TIME_UNSET)
    .build();

C.TIME_UNSET를 전달하면 시간 제한이 완전히 삭제되지만 MediaCodec이 중단될 수 있는 칩셋에서 앱이 실행되는 경우 0이 아닌 더 큰 제한 시간을 설정하는 것이 좋습니다.

Transformer는 8k 입력을 지원하나요?

Transformer는 형식에 구애받지 않는 방식으로 구현되므로 8K 동영상 처리를 제한하지 않지만 기기의 하드웨어 기능으로 인해 내보내기에 실패할 수 있습니다. 예를 들어 8K를 캡처할 수 있는 기기에서도 사용 가능한 하드웨어 코덱 또는 RAM 리소스를 초과하여 8K 동영상을 디코딩하거나 다시 인코딩하지 못할 수 있습니다.

Transformer는 플랫폼 호환 미디어 트랜스코딩과 어떤 관련이 있나요?

호환 미디어 트랜스코딩은 Android 12 (API 수준 31)의 Android 플랫폼 기능으로, 최대 길이 1분의 미디어를 앱에서 지원하는 형식으로 변환합니다. 이 기능을 사용하도록 선택한 경우 호환되지 않는 형식의 미디어 파일을 읽으면 요청 시 트랜스코딩되고 결과는 향후 읽기 작업을 위해 캐시됩니다.

Transformer는 형식 변환도 지원하지만 지원 라이브러리로 사용할 수 있으며 앱이 트랜스코딩 작업을 완전히 제어할 수 있습니다.

내보내기 지연 시간을 줄이거나 처리량을 늘리려면 어떻게 해야 하나요?

Transformer는 하드웨어 가속 디코딩 및 인코딩에 MediaCodec를 사용하고 동영상 프레임 처리에는 OpenGL을 사용합니다. 일반적인 기기에서 측정한 결과에 따르면 트랜스포머 처리량의 제한 요인은 고강도 효과 처리가 없는 사용 사례의 하드웨어 MediaCodec 인코더 처리량입니다. 이는 다른 구현에도 동일한 방식으로 영향을 미칠 수 있습니다. 예를 들어 플랫폼 호환 트랜스코딩 기능은 Transformer와 유사한 성능을 발휘합니다.

데모 앱의 디버그 미리보기를 사용하면 처리량이 크게 감소하므로 데모 앱의 출시 빌드로 테스트할 때 미리보기 기능을 사용 중지하여 실제 성능을 확인할 수 있습니다.