# SuperPlayer_iOS

**Repository Path**: mirrors_tencentyun/SuperPlayer_iOS

## Basic Information

- **Project Name**: SuperPlayer_iOS
- **Description**: Super player for iOS...
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-08-18
- **Last Updated**: 2025-08-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

简体中文| [English](./README-EN.md)

## 目录结构说明

本目录包含 iOS 版 播放器(Player) SDK 的Demo 源代码，主要演示接口如何调用以及最基本的功能。

```
├─ Demo // 播放器Demo
    ├── PlayerApp   // 程序入口界面
    ├── PlayerKit   // 播放器界面逻辑
    └── SuperPlayerKit    // 播放器组件
├─ Player-API-Example-iOS // 播放器API相关Demo
├─ Swift-Call-OC-Example  // Swift调用SDK API的实现样例
```
## **集成说明**
请参考[Wiki部分相关内容](https://github.com/LiteAVSDK/Player_iOS/wiki)

## **配置说明**
请参考[播放器集成相关配置](https://github.com/LiteAVSDK/Player_iOS/wiki/播放器集成相关配置)

## **Demo体验说明**
下载新版Demo后，需通过[TXLiveBase setLicence] 设置 Licence 后方可成功播放， 否则将播放失败（黑屏），全局仅设置一次即可。直播 Licence、短视频 Licence 和视频播放 Licence 均可使用，若您暂未获取上述 Licence ，可[快速免费申请测试版 Licence](https://cloud.tencent.com/act/event/License) 以正常播放，正式版 License 需[购买](https://cloud.tencent.com/document/product/881/74588#.E8.B4.AD.E4.B9.B0.E5.B9.B6.E6.96.B0.E5.BB.BA.E6.AD.A3.E5.BC.8F.E7.89.88-license)。
具体可以参考 [Wiki部分相关内容](https://github.com/LiteAVSDK/Player_iOS/wiki)


### 特别提醒
1.先进入目录PlayerApp 并进行 `pod install` 

2.申请到Licence URL 和 Licence URL 后，请用它们赋值给`Demo/PlayerKit/PlayerKit/App/config/Player.plist`文件的 licenceUrl 和 licenceKey 字段。

3.如果要体验高级版画中画功能，可前往 [腾讯云视立方控制台 > License 管理 > 移动端 License](https://console.cloud.tencent.com/vcube/mobile) 获取对应 LicenseURL 和 LicenseKey。如果没有申请 Player 高级套餐 License，进入画中画将无效。

4.如果要体验高级功能（短视频、透明动画、VR播放、终端极速高清等），请前往[腾讯云官网 > 播放器SDK > 高级功能 ](https://cloud.tencent.com/document/product/881/96686)

5.播放器SDK已经适配苹果最新的隐私清单，可以通过pod install 升级到 11.7.15343 及以后的版本


## **升级说明**

#### **License授权**
播放器 SDK 移动端10.1（Android & iOS & Flutter）开始 版本采用“腾讯视频”同款播放内核打造，视频播放能力获得全面优化升级。同时从该版本开始将增加对“视频播放”功能模块的授权校验，

  1、如果您的APP已经拥有直播推流 License 或者短视频 License 授权 ，当您升级至10.1 版本后仍可以继续正常使用，不受到此次变更影响，您可以登录 [腾讯云视立方控制台](https://console.cloud.tencent.com/vcube) 查看您当前的 License 授权信息。

  2、如果您在此之前从未获得过上述License授权，且需要使用新版本SDK（10.1及其更高版本）中的直播播放或点播播放功能，则需购买指定 License 获得授权，详情参见[授权说明](https://cloud.tencent.com/document/product/881/74199#.E6.8E.88.E6.9D.83.E8.AF.B4.E6.98.8E)；若您无需使用相关功能或未升级至最新版本SDK，将不受到此次变更的影响。

#### **SDK结构调整说明**
1、从11.6版本开始，播放器SDK支持在 **M1及其以上的设备上运行播放器的模拟器**，SDK的结构从**framework升级到xcframework**。可以自行更新11.6及以上版本的SDK进行体验。若您的项目是采用pods进行管理，则可以无缝进行版本切换。若您的项目是采用手动集成或私有pods进行管理，则需要更新一下SDK 头文件的搜索路径，否则会出现编译失败的情况。具体集成步骤可以参考 [腾讯云官网](https://cloud.tencent.com/document/product/881/20208) - 集成指引 - 手动下载 SDK

## SDK 分类和下载

腾讯云 Player SDK 提供**基础版本和高级版本**，产品功能的差异可查看播放器 SDK 官网[产品简介>产品功能](https://cloud.tencent.com/document/product/881/61375)：

- 如果您追求最小化体积增量，可以下载 Player 基础版：[TXLiteAVSDK_Player.zip](https://liteav.sdk.qcloud.com/download/latest/TXLiteAVSDK_Player_iOS_latest.zip)
- 如果您需要使用外挂字幕、多音轨、DRM 播放等高级功能，可以下载 Player 高级版：[TXLiteAVSDK_Player_Premium.zip](https://liteav.sdk.qcloud.com/download/latest/TXLiteAVSDK_Player_Premium_iOS_latest.zip)

## 相关文档链接

- [SDK 的版本更新历史](https://github.com/tencentyun/SuperPlayer_iOS/releases)
- [常见移动端播放问题](https://cloud.tencent.com/document/product/881/73976)
- [SDK 的 API 文档](https://github.com/tencentyun/SuperPlayer_iOS/wiki)
- [SDK 的官方体验 App](https://cloud.tencent.com/document/product/881/20204)