ExoPlayer는 Android의 MediaDrm API를 사용하여 DRM으로 보호되는 재생을 지원합니다.
지원되는 다양한 DRM 체계에 필요한 최소 Android 버전과
지원되는 스트리밍 형식에 대해서는
다음 표를 참조하세요.
DRM 방식
Android 버전 번호
Android API 레벨
지원되는 형식
Widevine 'cenc'
4.4
19
DASH, HLS (FMP4만 해당)
Widevine 'cbcs'
7.1
25
DASH, HLS (FMP4만 해당)
ClearKey 'cenc'
5.0
21
DASH
PlayReady SL2000 'cenc'
Android TV
Android TV
DASH, SmoothStreaming, HLS (FMP4만 해당)
ExoPlayer로 DRM 보호 콘텐츠를 재생하기 위해 DRM의 UUID
시스템을 지정해야 합니다.
미디어 항목을 빌드할 때 및 기타
속성을 제공할 수도 있습니다. 그런 다음 플레이어는 이러한 속성을 사용하여
DrmSessionManager의 기본 구현인
DefaultDrmSessionManager: 대부분의 사용 사례에 적합합니다. 일부 용도
이 경우 아래 설명된 대로 추가 DRM 속성이 필요할 수 있습니다.
섹션으로 이동합니다.
키 순환
회전 키로 스트림을 재생하려면 true를
미디어를 빌드할 때 MediaItem.DrmConfiguration.Builder.setMultiSession
있습니다.
여러 핵심 콘텐츠
멀티키 콘텐츠는 여러 스트림으로 구성되며 일부 스트림에서는
키를 사용하는 것입니다. 멀티키 콘텐츠는 다음 두 가지 방법 중 하나로 재생할 수 있습니다.
자세히 알아보겠습니다
사례 1: 라이선스 서버가 콘텐츠의 모든 키로 응답
이 경우 라이선스 서버는
요청이 있을 경우 콘텐츠의 모든 키로 응답합니다. 이 케이스는
특별한 구성 없이도 ExoPlayer에서 처리됩니다. 적응
다른 스트림 (예: SD 및 HD 동영상) 간에
키를 누릅니다.
가능한 경우 이
있습니다. 멀티키 재생을 지원하는 가장 효율적이고 강력한 방법입니다.
콘텐츠(클라이언트가 여러 개의 라이선스 요청을 할 필요가 없기 때문)
여러 스트림에 액세스할 수 있습니다.
사례 2: 라이선스 서버가 요청된 키만으로 응답
이 경우 라이선스 서버는
요청을 처리합니다 이 라이선스로 멀티키 콘텐츠를 재생할 수 있습니다.
true를 전달하여 서버 구성을
미디어를 빌드할 때 MediaItem.DrmConfiguration.Builder.setMultiSession
있습니다.
이 방식으로 작동하도록 라이선스 서버를 구성하지 않는 것이 좋습니다. 그것은
멀티키 콘텐츠를 재생하려면 추가 라이선스 요청이 필요하며,
위에서 설명한 대안보다 효율적이고 강력합니다.
오프라인 키
키 세트 ID를
미디어 항목을 빌드할 때 MediaItem.DrmConfiguration.Builder.setKeySetId
이렇게 하면
지정합니다.
<ph type="x-smartling-placeholder">
명확한 콘텐츠를 위한 DRM 세션
자리표시자 DrmSessions를 사용하면 ExoPlayer가 동일한 디코더를 사용할 수 있습니다.
클리어 콘텐츠를 사용하는 것이 좋습니다. 미디어에 다음이 포함된 경우
명확한 섹션과 암호화된 섹션이 모두 있는 경우 자리표시자 DrmSessions를 사용하는 것이 좋습니다.
명확한 데이터와 암호화된 레이어 사이에서 전환될 때 디코더가 다시 생성되는 것을 방지하기 위해
섹션이 발생할 수 있습니다. 오디오 및 동영상 트랙에 자리표시자 DrmSessions를 사용할 수 있습니다.
true를 전달하여 사용 설정할 수 있습니다.
MediaItem.DrmConfiguration.Builder.forceSessionsForAudioAndVideoTracks인 경우
확인할 수 있습니다.
맞춤 DrmSessionManager 사용
앱에서 재생에 사용되는 DrmSessionManager를 맞춤설정하려면 다음 단계를 따르세요.
DrmSessionManagerProvider를 구현하고 이를
MediaSource.Factory: 플레이어를 빌드할 때 사용됩니다. 제공업체가 할 수 있는 작업
매번 새 관리자 인스턴스를 인스턴스화할지 여부를 선택합니다. 항상
다음과 같이 동일한 인스턴스를 사용합니다.
Kotlin
valcustomDrmSessionManager:DrmSessionManager=CustomDrmSessionManager()// Pass a drm session manager provider to the media source factory.valmediaSourceFactory=DefaultMediaSourceFactory(context).setDrmSessionManagerProvider{customDrmSessionManager}
자바
DrmSessionManagercustomDrmSessionManager=newCustomDrmSessionManager(/* ... */);// Pass a drm session manager provider to the media source factory.MediaSource.FactorymediaSourceFactory=newDefaultMediaSourceFactory(context).setDrmSessionManagerProvider(mediaItem->customDrmSessionManager);
재생 성능 개선
YouTube Music에서 DRM으로 보호된 콘텐츠를 재생할 때 동영상 끊김 현상이 발생하는 경우
Android 6.0 (API 수준 23) 이상 버전 이상의 Android를 실행하는 기기
(Android 11(API 수준 30) 포함)에서 비동기 버퍼를 사용 설정하여
큐에 추가하는 방법을 자세히 알아보세요.
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 OpenJDK는 Oracle 및 Oracle 계열사의 상표 또는 등록 상표입니다.
최종 업데이트: 2025-07-27(UTC)
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-07-27(UTC)"],[],[],null,["# Digital rights management\n\nExoPlayer uses Android's [`MediaDrm`](/reference/android/media/MediaDrm) API to support DRM-protected playback.\nThe minimum Android versions required for different supported DRM schemes, along\nwith the streaming formats for which they're supported, are described in the\nfollowing table:\n\n| DRM scheme | Android version number | Android API level | Supported formats |\n|-------------------------|------------------------|-------------------|----------------------------------------|\n| Widevine \"cenc\" | 4.4 | 19 | DASH, HLS (FMP4 only) |\n| Widevine \"cbcs\" | 7.1 | 25 | DASH, HLS (FMP4 only) |\n| ClearKey \"cenc\" | 5.0 | 21 | DASH |\n| PlayReady SL2000 \"cenc\" | Android TV | Android TV | DASH, SmoothStreaming, HLS (FMP4 only) |\n\nIn order to play DRM-protected content with ExoPlayer, the UUID of the DRM\nsystem must be specified\n[when building a media item](/media/media3/exoplayer/media-items#protected-content), and other\nproperties can also be provided. The player will then use these properties to\nbuild a default implementation of `DrmSessionManager`, called\n`DefaultDrmSessionManager`, that's suitable for most use cases. For some use\ncases, additional DRM properties may be necessary, as outlined in the following\nsections.\n\n### Key rotation\n\nTo play streams with rotating keys, pass `true` to\n`MediaItem.DrmConfiguration.Builder.setMultiSession` when building the media\nitem.\n\n### Multi-key content\n\nMulti-key content consists of multiple streams, where some streams use different\nkeys than others. Multi-key content can be played in one of two ways, depending\non how the license server is configured.\n\n##### Case 1: License server responds with all keys for the content\n\nIn this case, the license server is configured so that when it receives a\nrequest for one key, it responds with all keys for the content. This case is\nhandled by ExoPlayer without the need for any special configuration. Adaptation\nbetween streams (e.g. SD and HD video) is seamless even if they use different\nkeys.\n\nWhere possible, we recommend configuring your license server to behave in this\nway. It's the most efficient and robust way to support playback of multikey\ncontent, because it doesn't require the client to make multiple license requests\nto access the different streams.\n\n##### Case 2: License server responds with requested key only\n\nIn this case, the license server is configured to respond with only the key\nspecified in the request. Multi-key content can be played with this license\nserver configuration by passing `true` to\n`MediaItem.DrmConfiguration.Builder.setMultiSession` when building the media\nitem.\n\nWe do not recommend configuring your license server to behave in this way. It\nrequires extra license requests to play multi-key content, which is less\nefficient and robust than the alternative described above.\n\n### Offline keys\n\nAn offline key set can be loaded by passing the key set ID to\n`MediaItem.DrmConfiguration.Builder.setKeySetId` when building the media item.\nThis allows playback using the keys stored in the offline key set with the\nspecified ID.\n| **[Known issue #3872:](https://github.com/google/ExoPlayer/issues/3872)** Only one offline key set can be specified per playback. As a result, offline playback of multi-key content is currently supported only when the license server is configured as described in Case 1 above.\n\n### DRM sessions for clear content\n\nUse of placeholder `DrmSessions` allows `ExoPlayer` to use the same decoders for\nclear content as are used when playing encrypted content. When media contains\nboth clear and encrypted sections, you may want to use placeholder `DrmSessions`\nto avoid re-creation of decoders when transitions between clear and encrypted\nsections occur. Use of placeholder `DrmSessions` for audio and video tracks can\nbe enabled by passing `true` to\n`MediaItem.DrmConfiguration.Builder.forceSessionsForAudioAndVideoTracks` when\nbuilding the media item.\n\n### Using a custom DrmSessionManager\n\nIf an app wants to customise the `DrmSessionManager` used for playback, they can\nimplement a `DrmSessionManagerProvider` and pass this to the\n`MediaSource.Factory` which is [used when building the player](/guide/topics/media/exoplayer/media-sources#customizing-media-source-creation). The provider can\nchoose whether to instantiate a new manager instance each time or not. To always\nuse the same instance: \n\n### Kotlin\n\n```kotlin\nval customDrmSessionManager: DrmSessionManager = CustomDrmSessionManager()\n// Pass a drm session manager provider to the media source factory.\nval mediaSourceFactory =\n DefaultMediaSourceFactory(context).setDrmSessionManagerProvider { customDrmSessionManager }\n```\n\n### Java\n\n```java\nDrmSessionManager customDrmSessionManager = new CustomDrmSessionManager(/* ... */ );\n// Pass a drm session manager provider to the media source factory.\nMediaSource.Factory mediaSourceFactory =\n new DefaultMediaSourceFactory(context)\n .setDrmSessionManagerProvider(mediaItem -\u003e customDrmSessionManager);\n```\n\n\u003cbr /\u003e\n\n### Improving playback performance\n\nIf you're experiencing video stuttering when playing DRM-protected content on a\ndevice running any version of Android from Android 6.0 (API level 23) up to and\nincluding Android 11 (API level 30), you can try [enabling asynchronous buffer\nqueueing](/guide/topics/media/exoplayer/customization#enabling-asynchronous-buffer-queueing)."]]
