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()를 호출할 때 사용하여 미디어 플레이어를 설정합니다.


생성자 파라미터

이름타입설명필수기본값
allowsBackgroundPlaybackBoolean백그라운드 재생을 허용할 지 여부Xfalse
allowsCellularAccessBoolean셀룰러 데이터 사용을 허용할 지 여부Xtrue
allowsPictureInPicturePlaybackBoolean화면 속 화면 모드를 허용할 지 여부Xtrue
controllerShowTimeoutjava.time.Duration컨트롤러를 보여줄 최대 시간X5초
defaultPlaybackRateFloat미디어의 재생 속도X1.0
seekBackwardIncrementjava.time.Duration현재 위치에서 전으로 이동하는 시간의 크기X10초
seekForwardIncrementjava.time.Duration현재 위치에서 후로 이동하는 시간의 크기X10초
screenOrientationLockScreenOrientationLock화면 고정 방향XOff
subtitleDisplayPositionSubtitleDisplayPosition자막 출력 위치XOnVideo
subtitleTextPositionFloat자막 위치X1.0
subtitleTextSizeSubtitleTextSize자막 크기XPixel(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.01.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~1f1f

자막 위치를 나타내는 속성입니다. 이 속성은 화면에서 자막이 배치될 위치를 비율로 표현하며, 값의 범위는 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

자막 출력 위치를 나타내는 열거형입니다.