MediaPlayerActivityConfiguration
import com.newin.nplayer.sdk.MediaPlayerActivityConfiguration
data class MediaPlayerActivityConfiguration(
var allowsBackgroundPlayback: Boolean,
var allowsCellularAccess: Boolean,
var allowsPictureInPicturePlayback: Boolean,
var controllerShowTimeout: Duration,
var defaultPlaybackRate: Float,
var seekBackwardIncrement: Duration,
var seekForwardIncrement: Duration,
var screenOrientationLock: ScreenOrientationLock,
var subtitleDisplayPosition: SubtitleDisplayPosition,
var subtitleTextPosition: Float,
var subtitleTextSize: SubtitleTextSize,
)
미디어 플레이어의 설정을 도와주는 데이터 클래스입니다. 아래와 같은 생성자 파라미터 및 속성, 열거형을 가지고 있습니다. configuration은 presentMediaPlayer()를 호출할 때 사용하여 미디어 플레이어를 설정합니다.
생성자 파라미터
이름 | 타입 | 설명 | 필수 | 기본값 |
---|---|---|---|---|
allowsBackgroundPlayback | Boolean | 백그라운드 재생을 허용할 지 여부 | X | false |
allowsCellularAccess | Boolean | 셀룰러 데이터 사용을 허용할 지 여부 | X | true |
allowsPictureInPicturePlayback | Boolean | 화면 속 화면 모드를 허용할 지 여부 | X | true |
controllerShowTimeout | java.time.Duration | 컨트롤러를 보여줄 최대 시간 | X | 5초 |
defaultPlaybackRate | Float | 미디어의 재생 속도 | X | 1.0 |
seekBackwardIncrement | java.time.Duration | 현재 위치에서 전으로 이동하는 시간의 크기 | X | 10초 |
seekForwardIncrement | java.time.Duration | 현재 위치에서 후로 이동하는 시간의 크기 | X | 10초 |
screenOrientationLock | ScreenOrientationLock | 화면 고정 방향 | X | Off |
subtitleDisplayPosition | SubtitleDisplayPosition | 자막 출력 위치 | X | OnVideo |
subtitleTextPosition | Float | 자막 위치 | X | 1.0 |
subtitleTextSize | SubtitleTextSize | 자막 크기 | X | Pixel(32) |
정적 속성
defaultConfiguration
companion object {
val defaultConfiguration: MediaPlayerActivityConfiguration
}
타입 | 설명 | 설정 |
---|---|---|
MediaPlayerActivityConfiguration | 기본 설정 값에 접근하기 위한 속성 | 불가능 |
기본 설정 값을 가져오는 정적 속성입니다. MediaPlayerActivityConfiguration.defaultConfiguration 를 사용하여 기본 설정 값을 가져올 수 있습니다.
속성
allowsBackgroundPlayback
var allowsBackgroundPlayback: Boolean = false
타입 | 설명 | 설정 | 기본값 |
---|---|---|---|
Boolean | 백그라운드 재생을 허용할 지 여부 | 가능 | false |
백그라운드 재생을 허용할 지 여부를 나타내는 속성입니다.
allowsCellularAccess
var allowsCellularAccess: Boolean = true
타입 | 설명 | 설정 | 기본값 |
---|---|---|---|
Boolean | 셀룰러 데이터 사용을 허용할 지 여부 | 가능 | true |
미디어를 재생할 때, 셀룰러 데이터를 사용할 지 여부를 나타내는 속성입니다.
allowsPictureInPicturePlayback
var allowsPictureInPicturePlayback: Boolean = true
타입 | 설명 | 설정 | 기본값 |
---|---|---|---|
Boolean | 화면 속 화면 모드를 허용할 지 여부 | 가능 | true |
화면 속 화면 모드를 허용할 지 여부를 나타내는 속성입니다.
controllerShowTimeout
var controllerShowTimeout: Duration = Duration.ofSeconds(5)
타입 | 설명 | 설정 | 기본값 |
---|---|---|---|
java.time.Duration | 컨트롤러를 자동으로 숨기는 시간 | 가능 | 5초 |
해당 시간만큼 아무 것도 입력하지 않으면 컨트롤러가 사라집니다. 0초로 설정할 경우에는 컨트롤러를 자동으로 숨기지 않습니다.
defaultPlaybackRate
var defaultPlaybackRate: Float = 1f
타입 | 설명 | 설정 | 범위 | 기본값 |
---|---|---|---|---|
Float | 미디어의 기본 재생 속도 | 가능 | 0.1~4.0 | 1.0 |
미디어 재생 속도를 나타내는 속성입니다.
seekBackwardIncrement
var seekBackwardIncrement: Duration = Duration.ofSeconds(10)
타입 | 설명 | 설정 | 기본값 |
---|---|---|---|
java.time.Duration | 현재 위치에서 전으로 이동하는 시간의 크기 | 가능 | 10초 |
현재 위치에서 전으로 탐색하는 시간을 나타내는 속성입니다.
seekForwardIncrement
var seekForwardIncrement: Duration = Duration.ofSeconds(10)
타입 | 설명 | 설정 | 기본값 |
---|---|---|---|
java.time.Duration | 현재 위치에서 후로 이동하는 시간의 크기 | 가능 | 10초 |
현재 위치에서 후로 탐색하는 시간을 나타내는 속성입니다.
screenOrientationLock
var screenOrientationLock: ScreenOrientationLock = ScreenOrientationLock.Off
타입 | 설명 | 설정 | 기본값 |
---|---|---|---|
ScreenOrientationLock | 화면 방향 고정 상태 | 가능 | Off |
화면의 고정 상태를 나타내는 속성입니다.
subtitleDisplayPosition
var subtitleDisplayPosition: SubtitleDisplayPosition = SubtitleDisplayPosition.OnVideo
타입 | 설명 | 설정 | 기본값 |
---|---|---|---|
SubtitleDisplayPosition | 자막 출력 위치 | 가능 | OnVideo |
자막 추력 위치를 나타내는 속성입니다.
subtitleTextPosition
var subtitleTextPosition: Float = 1f
타입 | 설명 | 설정 | 범위 | 기본값 |
---|---|---|---|---|
Float | 자막 위치 | 가능 | 0f~1f | 1f |
자막 위치를 나타내는 속성입니다. 이 속성은 화면에서 자막이 배치될 위치를 비율로 표현하며, 값의 범위는 0f에서 1f 사이입니다. 기본값은 1f으로, 자막이 화면의 맨 아래에 위치함을 의미합니다.
subtitleTextSize
var subtitleTextSize: SubtitleTextSize = SubtitleTextSize.Pixel(32)
타입 | 설명 | 설정 | 기본값 |
---|---|---|---|
SubtitleTextSize | 자막 크기 | 가능 | SubtitleTextSize.Pixel(32) |
자막 크기를 나타내는 속성입니다. 자막 크기를 픽셀 단위 또는 비율로 나타낼 수 있습니다.
클래스
SubtitleTextSize
sealed class SubtitleTextSize
자막 크기를 나타내는 클래스입니다.
열거형
ScreenOrientationLock
enum class ScreenOrientationLock
화면 방향 고정 상태를 나타내는 열거형입니다.
SubtitleDisplayPosition
enum class SubtitleDisplayPosition
자막 출력 위치를 나타내는 열거형입니다.