Files
yattee/Yattee/Services/OrientationManager.swift
2026-02-08 18:33:56 +01:00

114 lines
3.6 KiB
Swift

//
// OrientationManager.swift
// Yattee
//
// Provides supported interface orientations for the app.
// Supports in-app orientation locking when the player is visible.
//
#if os(iOS)
import UIKit
/// Provides supported interface orientations.
/// Supports in-app orientation locking to the current orientation.
@MainActor
final class OrientationManager {
static let shared = OrientationManager()
private init() {}
/// The orientation to lock to when `isLocked` is true.
/// Updated when orientation lock is enabled to capture current orientation.
private var lockedOrientation: UIInterfaceOrientationMask?
/// Whether orientation is currently locked.
private(set) var isLocked: Bool = false
/// Lock orientation to the current orientation
func lock() {
guard !isLocked else { return }
lockedOrientation = currentInterfaceOrientationMask
isLocked = true
notifyOrientationChange()
}
/// Lock to a specific orientation
func lock(to orientation: UIInterfaceOrientationMask) {
lockedOrientation = orientation
isLocked = true
notifyOrientationChange()
}
/// Re-lock to the current orientation (updates locked orientation even if already locked)
func lockToCurrentOrientation() {
lockedOrientation = currentInterfaceOrientationMask
isLocked = true
notifyOrientationChange()
}
/// Unlock orientation to allow all rotations again
func unlock() {
guard isLocked else { return }
isLocked = false
lockedOrientation = nil
notifyOrientationChange()
}
/// Returns the supported interface orientations.
/// When locked, returns only the locked orientation.
/// Otherwise: iPhone = all except upside-down, iPad = all
var supportedOrientations: UIInterfaceOrientationMask {
if isLocked, let locked = lockedOrientation {
return locked
}
if UIDevice.current.userInterfaceIdiom == .phone {
return .allButUpsideDown
} else {
return .all
}
}
/// Notify the system that supported orientations have changed
private func notifyOrientationChange() {
guard let windowScene = UIApplication.shared.connectedScenes
.compactMap({ $0 as? UIWindowScene })
.first(where: { $0.activationState == .foregroundActive })
else { return }
// Tell all view controllers to re-query supported orientations
for window in windowScene.windows {
window.rootViewController?.setNeedsUpdateOfSupportedInterfaceOrientations()
}
}
/// Get the current interface orientation as a mask
var currentInterfaceOrientationMask: UIInterfaceOrientationMask {
guard let windowScene = UIApplication.shared.connectedScenes
.compactMap({ $0 as? UIWindowScene })
.first(where: { $0.activationState == .foregroundActive })
else {
return .allButUpsideDown
}
let screenBounds = windowScene.screen.bounds
if screenBounds.width > screenBounds.height {
// Currently landscape - determine which side based on interface orientation
let interfaceOrientation = windowScene.interfaceOrientation
switch interfaceOrientation {
case .landscapeLeft:
return .landscapeLeft
case .landscapeRight:
return .landscapeRight
default:
return .landscape
}
} else {
return .portrait
}
}
}
#endif