UizaSDK
(向下滚动以阅读越南语)
UizaSDK 是连接到 Uiza 系统的框架
兼容性
UizaSDK 需要 Swift 4.2 和 iOS 8+、TVOS 10+
安装
CocoaPods (推荐)
要使用 CocoaPods 将 UizaSDK 集成到你的 Xcode 项目中,请在 Podfile
中指定它
pod 'UizaSDK' // for iOS 10+
pod 'UizaSDK_8' // for iOS 8,9
然后运行以下命令
$ pod install
手动安装
下载 UizaSDK.framework
并将其拖放到项目中,添加到“嵌入的二进制文件”部分
使用方法
框架初始化
在调用任何API函数之前,请使用以下行初始化框架
import UizaSDK
UizaSDK.initWith(appId: YOUR_APP_ID, token: TOKEN, api: YOUR_DOMAIN)
YOUR_APP_ID 和 YOUR_DOMAIN:从注册邮箱获取
TOKEN:从 https://docs.uiza.io/#get-api-key 生成
调用API
UZContentServices().loadDetail(entityId: ENTITY_ID, completionBlock: { (videoItem, error) in
if error != nil {
print("Error: \(error)")
}
else {
print("Video: \(videoItem)")
}
})
如何播放视频
let playerViewController = UZPlayerViewController()
playerViewController.player.loadVideo(entityId: ENTITY_ID)
present(playerViewController, animated: true, completion: nil)
可能需要将这些行添加到 Info.plist
以禁用App Transport Security (ATS),以便能够播放视频
<key>NSAppTransportSecurity</key>
<dict>
<key>NSAllowsArbitraryLoads</key><true/>
</dict>
如何直播
let viewController = UZLiveStreamViewController()
viewController.liveEventId = ENTITY_ID
self.present(viewController, animated: true, completion: nil)
请记住将这些使用描述键添加到 Info.plist
文件中
<key>NSCameraUsageDescription</key>
<string>App needs access to camera for livestream</string>
<key>NSMicrophoneUsageDescription</key>
<string>App needs access to microphone for livestream</string>
更改播放器主题
let playerViewController = UZPlayerViewController()
playerViewController.player.theme = UZTheme1()
UizaPlayer 当前有 7 个内置主题
创建自定义主题
您可以通过创建一个继承自UZPlayerTheme Protocol的类来创建自己的自定义主题,参考以下模板:UZCustomTheme
您还可以通过继承UZEndscreenView
来创建自定义结束屏幕,然后将实例设置为player.controlView.endscreenView
self.playerViewController.player.controlView.endscreenView = MyCustomEndScreen()
创建带有浮动模式的播放器
您可以通过继承UZFloatingPlayerViewController来创建像Facebook或YouTube一样的“拖动以浮动模式”的播放器,然后您可以为显示视频详情添加更多UI并将其添加到detailsContainerView
然后使用此代码显示
UZFloatingPlayerViewController().present(with: videoItem, playlist: playlist)
请参阅示例
有关API详细信息,请参阅API 文档
支持
许可协议
UizaSDK 采用BSD许可发布。有关详细信息,请参阅LICENSE
UizaSDK
UizaSDK 是一个支持连接到 Uiza 系统API的 Framework
tương thích
UizaSDK 需要Swift 4.2 和iOS 8+,TVOS 10+
安装
CocoaPods (推荐使用)
通过 CocoaPods 安装
在 Podfile
中添加以下行
pod 'UizaSDK' // dùng cho phiên bản iOS 10 trở lên
pod 'UizaSDK_8' // dùng cho phiên bản iOS 8,9
然后执行这个命令
$ pod install
自安装
下载 UizaSDK.framework
并将其拖入您的项目,将其添加到 Embbeded Binaries 中
使用方法
初始化
在使用任何API之前,始终先调用以下命令来启动框架
import UizaSDK
UizaSDK.initWith(appId: YOUR_APP_ID, token: TOKEN, api: YOUR_DOMAIN)
YOUR_APP_ID 和 YOUR_DOMAIN:从注册邮件中的信息中获取
TOKEN:在https://docs.uiza.io/#get-api-key 页面上创建
调用API函数
UZContentServices().loadDetail(entityId: ENTITY_ID, completionBlock: { (videoItem, error) in
if error != nil {
print("Error: \(error)")
}
else {
print("Video: \(videoItem)")
}
})
播放视频的方法
let playerViewController = UZPlayerViewController()
playerViewController.player.loadVideo(entityId: ENTITY_ID)
present(playerViewController, animated: true, completion: nil)
如果由于App Transport Security (ATS)问题导致视频无法播放,您必须在Info.plist
文件中添加以下行以播放视频:
<key>NSAppTransportSecurity</key>
<dict>
<key>NSAllowsArbitraryLoads</key><true/>
</dict>
直播播放方法
let viewController = UZLiveStreamViewController()
viewController.liveEventId = [ENTITY_ID]
self.present(viewController, animated: true, completion: nil)
请记住在Info.plist
文件中添加对摄像头和麦克风访问功能的描述要求
<key>NSCameraUsageDescription</key>
<string>App cần truy cập camera để phát livestream</string>
<key>NSMicrophoneUsageDescription</key>
<string>App cần truy cập micro để thu tiếng khi phát livestream</string>
更改界面
let playerViewController = UZPlayerViewController()
playerViewController.player.theme = UZTheme1()
UizaPlayer提供以下7种界面:
自定义界面
您可以通过创建一个继承自UZPlayerTheme协议的类来创建自己的界面,代码模板如下:UZCustomTheme
您还可以通过创建一个继承自UZEndscreenView
的类来更改结束屏幕的界面,然后将其添加到player.controlView.endscreenView
self.playerViewController.player.controlView.endscreenView = MyCustomEndScreen()
创建悬浮模式播放器
您可以通过创建一个继承自UZFloatingPlayerViewController的类来创建一个带有“拖到屏幕角落”功能的播放器,类似于Facebook或YouTube。在该类中,您可以添加视频显示的UI细节并将其放入detailsContainerView
。
然后使用以下命令展示:
UZFloatingPlayerViewController().present(with: videoItem, playlist: playlist)
查看示例
查看详细API文档