풀스크린 회전

풀스크린, 컨트롤, 종횡비는 SDK 내부(UIWindow)에서 처리합니다. 다만 디바이스 가로 회전은 SDK 가 단독으로 소유할 수 없으므로 호스트 앱에서 회전 마스크를 위임하는 설정이 필요합니다.

AppDelegate 설정 (필수)

호스트 앱의 AppDelegate 에서 지원 회전 마스크를 SDK 의 OrientationManager 에 위임합니다.

AppDelegate.swift

func application(_ app: UIApplication,
                 supportedInterfaceOrientationsFor window: UIWindow?) -> UIInterfaceOrientationMask {
    OrientationManager.shared.currentMask
}

Info.plist 설정

Info.plist 의 지원 방향에 Landscape Left / Landscape Right 를 허용해야 합니다. 이 설정이 없으면 풀스크린 진입 시 회전이 동작하지 않습니다.

Info.plist

<key>UISupportedInterfaceOrientations</key>
<array>
    <string>UIInterfaceOrientationPortrait</string>
    <string>UIInterfaceOrientationLandscapeLeft</string>
    <string>UIInterfaceOrientationLandscapeRight</string>
</array>

두 설정 모두 필요 — AppDelegate 위임과 Info.plist 가로 방향 허용이 모두 있어야 풀스크린 가로 회전이 정상 동작합니다.

자동 풀스크린

재생 준비 시 1회 자동으로 풀스크린에 진입하려면 autoFullscreen: true 를 지정합니다.

VpePlayer(accessKey: key, autoFullscreen: true, optionsJSON: json)