Monoscopic 360° video support

[defagos]

This release adds support for monoscopic 360° video and further improves Picture in Picture behavior.

360° video support

• Add support for monoscopic 360° videos to VideoView. Use the new VideoView/viewport(_:) modifier to enable 360° display and choose and set an orientation in space.
• Orientation in space requires a quaternion. Two SCNQuaternionRotate(_:_:_:) and SCNQuaternionWithAngleAndAxis(_:_:_:_:) functions are provided to help build relevant quaternions, most notably for controlling the viewport through touch events. On iOS the SCNQuaternionForAttitude(_:) function makes it possible to bridge quaternions delivered by CoreMotion with SceneKit quaternions required used by Pillarbox.

Picture in Picture improvements

• Improve Picture in Picture integration and overall behavior.
• Introduce PictureInPicturePersistable that lets app locally respond to Picture in Picture life cycle events if needed.

Improvements

• Add playback speed menu to the tvOS system player view layout.
• Add AVPlayerItem/seek(_:) method to set a player item to start at a given time.
• Add Player/isRunning property.
• Improve documentation and tutorials.

Demo improvements

• Greatly improve tvOS navigation user experience.
• Improve Picture in Picture integration in demo examples.
• Display Pillarbox web demo in a web browser. This feature is not intended to be easily accessible and requires a dedicated opt-in to be enabled in app system settings first.

Fixes

• Update Swift package manifest version to 5.9.

Breaking changes

• Prefix all frameworks with Pillarbox to avoid potential naming conflicts with packages providing frameworks having the same name.
• Update in-app Picture in Picture in-app integration API. The View/enabledForInAppPictureInPictureWithCleanup(perform:) method has been replaced with the View/enabledForInAppPictureInPicture(persisting:) method which, instead of executing a closure to cleanup resources associated with a player (potentially after Picture in Picture ends), ensures a PictureInPicturePersistable object is kept alive during Picture in Picture playback. The PictureInPicturePersistable protocol can be optionally used to locally respond to Picture in Picture lifef cycle events as well.
• Update VideoView and SystemVideoView APIs so that optional behaviors (gravity, Picture in Picture support) are configured with modifiers instead of parameters.

What's Changed

• Update Swift Package manifest to Swift 5.9 by @defagos in Update Swift Package manifest to Swift 5.9 #686
• Add tracking documentation by @defagos in Add tracking documentation #685
• Add Picture in Picture tutorial by @waliid in Add Picture in Picture tutorial #687
• Reoganize Player documention by @waliid in Reoganize Player documention #688
• Document analytics integration by @defagos in Document analytics integration #689
• Polish documentation by @defagos in Polish documentation #690
• Enhance code documentation by moving some references in appropriate sections by @waliid in Enhance code documentation by moving some references in appropriate sections #691
• Polish articles by @defagos in Polish articles #692
• Set the correct duration for completing tutorials by @waliid in Set the correct duration for completing tutorials #693
• Improve tvOS navigation by @waliid in Improve tvOS navigation #694
• Update cells appearance for tvOS by @waliid in Update cells appearance for tvOS #695
• Enhance cells appearance for tvOS by @waliid in Enhance cells appearance for tvOS #699
• Improve the display of examples on tvOS by @waliid in Improve the display of examples on tvOS #701
• Document SwiftUI property wrapper usage recommendations by @defagos in Document SwiftUI property wrapper usage recommendations #706
• Update dependencies to most recent versions by @defagos in Update dependencies to most recent versions #709
• Add monoscopic 360° video support by @defagos in Add monoscopic 360° video support #702
• Add an access to Pillarbox Web via a WebView by @waliid in Add an access to Pillarbox Web via a WebView #711
• Fix missing media information in iOS cells by @waliid in Fix missing media information in iOS cells #712
• Animate video view display by @defagos in Animate video view display #713
• Rename packages to avoid potential conflicts by @defagos in Rename packages to avoid potential conflicts #714
• Update Xcode version used for CI to to 15.2 by @defagos in Update Xcode version used for CI to to 15.2 #715
• Fix product name conflicts by @defagos in Fix product name conflicts #719
• Make player animations smoother by @defagos in Make player animations smoother #720
• Revise some documentation images by @waliid in Revise some documentation images #721
• Implementing Playback Speed Feature on tvOS by @waliid in Implementing Playback Speed Feature on tvOS #718
• Create a computed property to detect non-zero playback rates by @waliid in Create a computed property to detect non-zero playback rates #722
• Remove superfluous selves by @defagos in Remove superfluous selves #723
• Support starting playback at a given time by @defagos in Support starting playback at a given time #724

Full Changelog: 0.8.0...0.9.0

---

This discussion was created from the release Monoscopic 360° video support.