入门
TPStreamsSDK 是一个支持 DRM（FairPlay）和非 DRM 内容的通用的 iOS 原生 SDK。
要求
在将 TPStreamsSDK 集成到您的 iOS 应用程序之前，请确保您的项目满足以下要求
- 最低部署版本：iOS 14 或更高版本
- Swift：版本 5.5 或更高版本
使用 Swift 包管理器（SPM）进行集成
要使用 Swift Package Manager 将 TPStreamsSDK 添加到您的 Xcode 项目，请按照以下步骤操作
- 在 Xcode 中选择文件 > 添加包。
- 在搜索栏中，输入以下 URL：
https://github.com/testpress/iOSPlayerSDK。 - 从搜索结果中选择 'iOSPlayerSDK'。点击添加包按钮。
包添加完成后，您就可以开始在您的 iOS 应用程序中使用 TPStreamsSDK。
初始化 TPStreamsSDK
在您的 AppDelegate 的 application(_:didFinishLaunchingWithOptions:) 方法中，调用 TPStreamsSDK.initialize(withOrgCode:) 以使用您的组织代码初始化 SDK。
class AppDelegate: UIResponder, UIApplicationDelegate {
func application(_ application: UIApplication,didFinishLaunchingWithOptions launchOptions [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
TPStreamsSDK.initialize(withOrgCode: "YOUR_ORGANIZATION_CODE")
return true
}
}
请注意，上述代码假设您正在使用 SwiftUI。如果您使用不同的应用架构，您可能需要相应地调整集成步骤。
使用 TPStreamsSDK 播放视频
SwiftUI 集成
- 通过提供适当的 assetID 和 accessToken 来创建一个 TPAVPlayer。
- 将 TPStreamPlayerView 嵌入您的 SwiftUI 视图。
struct ContentView: View {
let player = TPAVPlayer(assetID: "YOUR_ASSET_ID", accessToken: "YOUR_ACCESS_TOKEN")
var body: some View {
VStack {
TPStreamPlayerView(player: player)
.frame(height: 240)
Spacer()
}
}
}
UIKit 集成
- 使用相关的 assetID 和 accessToken 创建一个 TPAVPlayer。
- 创建一个 TPStreamPlayerViewController，并将先前创建的 TPAVPlayer 分配给 player 属性。
- 将 TPStreamPlayerViewController.view 添加到视图层次结构。这将显示在指定的 playerContainer 视图中播放的视频播放器。
class ViewController: UIViewController {
@IBOutlet weak var playerContainer: UIView!
var playerViewController: TPStreamPlayerViewController?
var player: TPAVPlayer?
override func viewDidLoad() {
super.viewDidLoad()
self.setupPlayerView()
player?.play()
}
func setupPlayerView(){
player = TPAVPlayer(assetID: "YOUR_ASSET_ID", accessToken: "YOUR_ACCESS_TOKEN")
playerViewController = TPStreamPlayerViewController()
playerViewController?.player = player
addChild(playerViewController!)
playerContainer.addSubview(playerViewController!.view)
playerViewController!.view.frame = playerContainer.bounds
}
}TPAVPlayer 是 AVPlayer 的包装类，为播放我们的视频提供内置支持，无需额外努力。它还支持为受 DRM 保护的内容提供 FairPlay 流媒体。
由于 TPAVPlayer 是 AVPlayer 的包装类，因此您还可以使用 TPAVPlayer 与原生的 iOS 播放器一起播放流式视频。
有关 TPStreamsSDK 的实际实现和用法，请参阅我们的示例 iOS 应用。