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.0 | 1.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.0 | 1.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에서 확인하세요.