MediaItem
import androidx.media3.common.MediaItem
미디어 아이템의 정보를 가져올 수 있는 위의 속성 및 메서드를 제공합니다. Agent에서 설정한 값을 불러올 수 있습니다.
속성
disablePlaybackRate
val MediaItem.disablePlaybackRate: Boolean
| 타입 | 설명 | 설정 | 기본값 |
|---|---|---|---|
| Boolean | 배속 기능 허용 여부 | 불가능 | false |
미디어의 배속 기능 허용 여부를 나타내는 속성입니다.
returnUrl
val MediaItem.returnUrl: Uri?
| 타입 | 설명 | 설정 |
|---|---|---|
| android.net.Uri? | 미디어 아이템의 리턴 Url | 불가능 |
Agent에서 설정한 미디어 아이템의 리턴 Url입니다.
참고: MediaItem내의 returnUrl
seekable
val MediaItem.seekable: Boolean
| 타입 | 설명 | 설정 | 기본값 |
|---|---|---|---|
| Boolean | 탐색(Seek) 기능 허용 여부 | 불가능 | true |
미디어의 Seek 기능 허용 여부를 나타내는 속성입니다.
title
val MediaItem.title: CharSequence?
| 타입 | 설명 | 설정 |
|---|---|---|
| CharSequence? | 미디어의 제목 | 불가능 |
미디어 메타 데이터에 저장된 제목을 가져오는 속성입니다. 만약 미디어 메타 데이터에 제목이 없다면, 파일 이름을 가져옵니다.
uri
val MediaItem.uri: Uri?
| 타입 | 설명 | 설정 |
|---|---|---|
| android.net.Uri? | 미디어 아이템의 주소 | 불가능 |
미디어 아이템에 따라 로컬 주소가 나올 수도 있고, 웹 주소도 나올 수 있습니다.
useBookmarkCallback
val MediaItem.useBookmarkCallback: Boolean
| 타입 | 설명 | 설정 |
|---|---|---|
| Boolean | 북마크 콜백 사용 | 불가능 |
메서드
withDrmConfiguration
import com.newin.nplayer.sdk.extensions.withDrmConfiguration
fun MediaItem.withDrmConfiguration(
appId: String,
userId: String,
userData: Map<String, Any> = emptyMap(),
offlineAccessPeriod: Duration? = null,
): MediaItem
| 이름 | 타입 | 설명 | 필수 | 기본값 |
|---|---|---|---|---|
| appId | String | App 아이디 | O | 없음 |
| userId | String | 사용자 아이디 | O | 없음 |
| userData | Map<String, Any> | 사용자 데이터 | X | emptyMap() |
| offlineAccessPeriod | java.time.Duration? | 오프라인 재생 기한 | X | null |
App 아이디와 사용자 아이디를 사용하여 DRM 설정을 하는 메서드입니다. Callback URL에 전달할 데이터(사용자 데이터)와 오프라인 재생 기한 설정을 추가하여 DRM 설정을 할 수 있습니다.