Pillarbox is the iOS and tvOS modern reactive SRG SSR player ecosystem implemented on top of AVFoundation and AVKit. Pillarbox has been designed with robustness, efficiency and flexibilty in mind, with full customization of:
- Metadata and asset URL retrieval.
- Asset resource loading, including support for FairPlay.
- Analytics and QoS integration.
- User interface layout in SwiftUI.
Its robust player provides all essential playback features you might expect:
- Audio and video (standard / monoscopic 360°) playback.
- Support for on-demand and live streams (with or without DVR).
- First-class integration with SwiftUI to create the stunning playback user experience that your application deserves.
- Integration with the standard system playback user experience, both on iOS and tvOS.
- Playlist management including bidirectional navigation.
- Support for alternative audio tracks, Audio Description, subtitles, CC and SDH, all tightly integrated with standard system accessibility features.
- AirPlay compatibility.
- Control center integration.
- Multiple instance support.
- Best-in-class Picture in Picture support.
- The smoothest possible seek experience on Apple devices, with blazing-fast content navigation in streams enabled for trick play.
- Playback speed controls.
In addition Pillarbox provides the ability to play all SRG SSR content through a dedicated package.
Here are a few examples of layouts which can be achieved using Pillarbox and SwiftUI, directly borrowed from our demo project:
From left to right:
- Screenshots 1, 2 and 3: Rich custom player user interface.
- Screenshot 4: Player with associated playlist.
- Screenshot 5: Stories.
With Pillarbox creating a custom video player user interface has never been easier. Simply instantiate a Player and start building your user interface in SwiftUI right away:
import PillarboxPlayer
import SwiftUI
struct PlayerView: View {
@StateObject private var player = Player(
item: .simple(url: URL(string: "https://devstreaming-cdn.apple.com/videos/streaming/examples/img_bipbop_adv_example_ts/master.m3u8")!)
)
var body: some View {
ZStack {
VideoView(player: player)
Button(action: player.togglePlayPause) {
Image(systemName: player.shouldPlay ? "pause.circle.fill" : "play.circle.fill")
.resizable()
.frame(width: 80, height: 80)
}
}
.onAppear(perform: player.play)
}
}With the expressiveness of SwiftUI, our rich playback API and the set of components at your disposal you will have a full-fledged player user interface in no time.
The library is suitable for applications running on iOS 16, tvOS 16 and above. The project is meant to be compiled with the latest versions of Xcode and of the Swift compiler.
If you want to contribute to the project have a look at our contributing guide.
The library can be integrated using Swift Package Manager directly within Xcode. You can also declare the library as a dependency of another one directly in the associated Package.swift manifest.
If you want your application to run on Silicon Macs as an iPad application you must add -weak_framework MediaPlayer to your target Other Linker Flags setting.
The package provides a single plugin which automatically inserts correct versioning information into binaries. This plugin must be trusted interactively when a project integrating Pillarbox is built using Xcode for the first time.
On a continuous integration server you must trust plugins automatically by setting an appropriate default:
defaults write com.apple.dt.Xcode IDESkipPackagePluginFingerprintValidatation -bool YESIf you are using Xcode Cloud this can be achieved with a custom build script.
If your project is built with xcodebuild directly the same effect can be achieved by passing the -skipPackagePluginValidation option.
To learn more about integration of Pillarbox into your project please have a look at our generated Xcode documentation.
Documentation is available as a DocC documentation catalog. This catalog must be built by opening the project with Xcode and selecting Product > Build Documentation. You can then access it right from within the Xcode documentation window.
Further documentation is also available by following the links below:
See the LICENSE file for more information.