MediaPlayerViewController.Configuration

struct Configuration

미디어 플레이어의 설정을 도와주는 구조체입니다. 아래와 같은 속성, 메서드 및 열거형을 가지고 있습니다.


속성

allowsBackgroundPlayback

var allowsBackgroundPlayback: Bool = false
타입설명설정기본값
Bool백그라운드 재생을 허용할 지 여부가능false

백그라운드 재생을 허용할 지 여부를 나타내는 속성입니다.

allowsCellularAccess

var allowsCellularAccess: Bool = true
타입설명설정기본값
Bool셀룰러 데이터 사용을 허용할 지 여부가능true

미디어를 재생할 때, 셀룰러 데이터를 사용할 지 여부를 나타내는 속성입니다.

allowsPictureInPicturePlayback

var allowsPictureInPicturePlayback: Bool = true
타입설명설정기본값
Bool화면 속 화면 모드를 허용할 지 여부가능true

화면 속 화면 모드를 허용할 지 여부를 나타내는 속성입니다.

controllerShowTimeout

var controllerShowTimeout: Duration = .seconds(5)
타입설명설정기본값
Duration컨트롤러를 자동으로 숨기는 시간가능5초

해당 시간만큼 아무 것도 입력하지 않으면 컨트롤러가 사라집니다. 0초로 설정할 경우에는 컨트롤러를 자동으로 숨기지 않습니다.

defaultPlaybackRate

var defaultPlaybackRate: Float = 1
타입설명설정범위기본값
Float미디어의 기본 재생 속도가능0.1~4.01.0

미디어 재생 속도를 나타내는 속성입니다.

seekBackwardIncrement

var seekBackwardIncrement: Duration = .seconds(10)
타입설명설정기본값
Duration현재 위치에서 전으로 이동하는 시간의 크기가능10초

현재 위치에서 전으로 탐색하는 시간을 나타내는 속성입니다.

참고: Duration

seekForwardIncrement

var seekForwardIncrement: Duration = .seconds(10)
타입설명설정기본값
Duration현재 위치에서 후로 이동하는 시간의 크기가능10초

현재 위치에서 후로 탐색하는 시간을 나타내는 속성입니다.

참고: Duration

screenOrientationLock

var screenOrientationLock: ScreenOrientationLock = .off
타입설명설정기본값
ScreenOrientationLock화면 방향 고정 상태가능.off

화면 방향 고정 상태를 나타내는 속성입니다.

subtitleDisplayPosition

var subtitleDisplayPosition: SubtitleDisplayPosition = .onVideo
타입설명설정기본값
SubtitleDisplayPosition자막 출력 위치가능.onVideo

자막 출력 위치를 나타내는 속성입니다.

subtitleTextPosition

var subtitleTextPosition: CGFloat = 1
타입설명설정범위기본값
CGFloat자막 위치가능0.0~1.01.0

자막 위치를 나타내는 속성입니다. 이 속성은 화면에서 자막이 배치될 위치를 비율로 표현하며, 값의 범위는 0.0에서 1.0 사이입니다. 기본값은 1.0으로, 자막이 화면의 맨 아래에 위치함을 의미합니다.

subtitleTextSize

var subtitleTextSize: SubtitleTextSize = .pixel(32)
타입설명설정기본값
SubtitleTextSize자막 크기가능.pixel(32)

자막 크기를 나타내는 속성입니다. 자막 크기를 픽셀 단위 또는 비율로 나타낼 수 있습니다.


정적 메서드

defaultConfiguration()

static func defaultConfiguration() -> Configuration

기본 설정 값을 가져오는 정적 메서드입니다.


열거형

ScreenOrientationLock

enum ScreenOrientationLock: String

화면 방향 고정 상태를 나타내는 열거형입니다. 자세한 설명은 MediaPlayerViewController.Configuration.ScreenOrientationLock에서 확인하세요.

SubtitleDisplayPosition

typealias SubtitleDisplayPosition = MediaPlayer.SubtitleDisplayPosition

자막 출력 위치를 나타내는 열거형입니다. 자세한 설명은 MediaPlayer.SubtitleDisplayPosition에서 확인하세요.