Pillarbox 是基于 AVFoundation 和 AVKit 实现的 iOS 和 tvOS 现代响应式 SRG SSR 播放器生态系统。 Pillarbox 的设计着眼于稳健性、效率和灵活性，并可对以下内容进行完全自定义：

• 元数据和资源 URL 的检索。
• 资源加载，包括对 FairPlay 的支持。
• 分析和监控集成。
• SwiftUI 中的用户界面布局。

Pillarbox 播放器提供了您可能期望的所有基本播放功能：

• 音频和视频（标准/单视场 360°）播放。
• 支持点播和直播流（带或不带 DVR）。
• 与 SwiftUI 的一流集成，可创建您的应用程序应有的令人惊叹的播放用户体验。
• 与 iOS 和 tvOS 上的标准系统播放用户体验集成。
• 播放列表管理，包括双向导航。
• 支持备用音轨、音频描述、字幕、CC 和 SDH，所有这些都与标准系统辅助功能紧密集成。
• 元数据和章节支持。
• AirPlay 兼容性。
• 控制中心集成。
• 支持多个实例。
• 一流的画中画支持。
• 在 Apple 设备上提供尽可能流畅的搜索体验，并在支持特技播放的流中实现快速的内容导航。
• 播放速度控制。
• 循环播放。
• 使用 Pillarbox 体验质量 (QoE) 和服务质量 (QoS) 平台进行监控。

此外，Pillarbox 还提供了通过专用软件包播放所有 SRG SSR 内容的功能。

以下是一些可以使用 Pillarbox 和 SwiftUI 实现的布局示例，直接取自我们的演示项目：

从左到右：

• 屏幕截图 1、2 和 3：丰富的自定义播放器用户界面。
• 屏幕截图 4：带有相关播放列表的播放器。
• 屏幕截图 5：故事。
• 屏幕截图 6：自定义章节导航。

该库适用于在 iOS 16、tvOS 16 及更高版本上运行的应用程序。

可以使用 Swift Package Manager 直接在 Xcode 中集成该库。 您也可以直接在相关的 Package.swift 清单中将该库声明为另一个库的依赖项。

如果您希望您的应用程序作为 iPad 应用程序在 Silicon Mac 上运行，则必须将 -weak_framework MediaPlayer 添加到目标其他链接器标志设置中。

Pillarbox 文档包括文章、教程和 API 参考，以帮助您了解更多有关可用功能以及如何将它们集成到您的应用程序中的信息。

文档以 DocC 文档目录的形式提供。 必须通过使用 Xcode 打开项目并选择产品 > 构建文档来构建此目录。 然后，您可以直接从 Xcode 文档窗口中访问它。

Pillarbox 提供的每个主要产品的文档也可以在 Swift Package Index 上找到

• Player：创建引人入胜的音频和视频播放体验。
• CoreBusiness：使用 Player 框架播放 SRG SSR 内容。
• Monitoring：监控播放活动。
• Analytics：根据 SRG SSR 要求衡量应用程序使用情况。

以下是配套产品的文档

• Core：实现 Pillarbox 时使用的基本工具。
• Circumspect：一个基于 Nimble 的框架，用于测试 Combine 发布者。

还可以通过以下链接获取更多文档：

• 已知问题
• 开发工具
• 持续集成

该软件包提供一个插件，该插件会自动将正确的版本信息插入到二进制文件中。 首次使用 Xcode 构建集成 Pillarbox 的项目时，必须以交互方式信任此插件。

在持续集成服务器上，您必须通过设置适当的默认值来自动信任插件

defaults write com.apple.dt.Xcode IDESkipPackagePluginFingerprintValidatation -bool YES

如果您使用的是 Xcode Cloud，可以使用 自定义构建脚本来实现此目的。

如果您的项目直接使用 xcodebuild 构建，则可以通过传递 -skipPackagePluginValidation 选项来实现相同的效果。

使用 Pillarbox 创建自定义视频播放器用户界面从未如此简单。 只需实例化一个 Player 并立即开始在 SwiftUI 中构建您的用户界面：

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)
    }
}

借助 SwiftUI 的表达能力、我们丰富的播放 API 以及您可以使用的组件集，您将立即拥有一个功能齐全的播放器用户界面。

如果您想为该项目做出贡献，请查看我们的贡献指南。

有关更多信息，请参见LICENSE文件。