Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

【iOS】国际版移动直播更新 #451

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -11,22 +11,22 @@
### 方法一:自动加载(aar)
因为 jcenter 已经下线,您可以通过在 gradle 配置 mavenCentral 库,自动下载更新 LiteAVSDK。
只需要用 Android Studio 打开需要集成 SDK 的工程,然后通过简单的四个步骤修改 `build.gradle` 文件,就可以完成 SDK 集成:
![](https://main.qcloudimg.com/raw/2ca6cc6e3f00dc9fdb2d89982861f3ea.png)
![](https://qcloudimg.tencent-cloud.cn/raw/288cbffd943bd8c03c3863980cf00455.png)

1. 打开 app 下的 build.gradle。
2. 在 dependencies 中添加 LiteAVSDK 的依赖。
<dx-codeblock>
::: jar
dependencies {
implementation 'com.tencent.liteav:LiteAVSDK_Professional:latest.release'
implementation 'com.tencent.liteav:LiteAVSDK_International:latest.release'
}
:::
</dx-codeblock>
<dx-codeblock>
::: jar
dependencies {
implementation 'com.tencent.liteav:LiteAVSDK_Professional:latest.release@aar'
implementation 'com.tencent.liteav:LiteAVSDK_International:latest.release@aar'
}
:::
</dx-codeblock>
Expand All @@ -45,15 +45,15 @@ defaultConfig {
### 方法二:手动下载(aar)
如果您的网络连接 mavenCentral 有问题,也可以手动下载 SDK 集成到工程里:

1. 下载 [LiveAVSDK](https://intl.cloud.tencent.com/document/product/1071/38150) ,下载完成后进行解压。
1. 下载 [LiteAVSDK](https://intl.cloud.tencent.com/document/product/1071/38150) ,下载完成后进行解压。
2. 将下载文件解压之后 SDK 目录下的 aar 文件拷贝到工程的 **app/libs** 目录下:
![](https://main.qcloudimg.com/raw/09ee3b005ff8d4ef33bafb6ce3135239.png)
![](https://qcloudimg.tencent-cloud.cn/raw/32b42946b8240fa3c2b4066091a6bc1c.png)
3. 在工程根目录下的 build.gradle 中,添加 **flatDir**,指定本地仓库路径。
![](https://main.qcloudimg.com/raw/726771558714a2b4fae8dc1a59c33ffc.png)
4. 添加 LiteAVSDK 依赖,在 app/build.gradle 中,添加引用 aar 包的代码。
![](https://main.qcloudimg.com/raw/224f40522354b0fe8de1bd1680cb54e0.jpg)
![](https://qcloudimg.tencent-cloud.cn/raw/ad7f3e2ce465c7d47f7d71f020cb02a2.png)
```
implementation(name:'LiteAVSDK_Professional_8.7.10102', ext:'aar')
implementation(name:'LiteAVSDK_International_8.7.10102', ext:'aar')
```
5. 在 `app/build.gradle` 的 defaultConfig 中,指定 App 使用的 CPU 架构(目前 LiteAVSDK 支持 armeabi 、armeabi-v7a 和 arm64-v8a)。
```
Expand All @@ -68,7 +68,7 @@ defaultConfig {
## 集成 SDK(jar)
如果您不想集成 aar 库,也可以通过导入 jar 和 so 库的方式集成 LiteAVSDK:

1. 下载 [LiveAVSDK](https://intl.cloud.tencent.com/document/product/1071/38150) ,下载完成后进行解压。在 SDK 目录下找到 `LiteAVSDK_Professional_xxx.zip`(其中 `xxx` 为 LiteAVSDK 的版本号):
1. 下载 [LiteAVSDK](https://intl.cloud.tencent.com/document/product/1071/38150) ,下载完成后进行解压。在 SDK 目录下找到 `LiteAVSDK_International_xxx.zip`(其中 `xxx` 为 LiteAVSDK 的版本号):
![](https://main.qcloudimg.com/raw/aae5879bccd31e8c082eebc24aa4ff7c.png)
解压后得到 libs 目录,里面主要包含 jar 文件和 so 文件夹,文件清单如下:
![](https://main.qcloudimg.com/raw/e916aaddf844785991dc25f78776d773.png)
Expand Down
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@

本文主要介绍如何快速地将腾讯云视立方·移动直播 LiteAVSDK(iOS)集成到您的项目中,按照如下步骤进行配置,就可以完成 SDK 的集成工作。下面以全功能的 [移动直播专业版 SDK](https://intl.cloud.tencent.com/document/product/1071/38150) 为例:
本文主要介绍如何快速地将腾讯云视立方·移动直播 LiteAVSDK(iOS)集成到您的项目中,按照如下步骤进行配置,就可以完成 SDK 的集成工作。

## 开发环境要求
- Xcode 9.0+。
Expand Down Expand Up @@ -31,7 +31,7 @@ pod init
platform :ios, '9.0'

target 'App' do
pod 'TXLiteAVSDK_Professional', :podspec => 'https://liteav.sdk.qcloud.com/pod/liteavsdkspec/TXLiteAVSDK_Professional.podspec'
pod 'TXLiteAVSDK_International', :podspec => 'https://liteav.sdk.qcloud.com/pod/liteavsdkspec/TXLiteAVSDK_International.podspec'
end
:::
</dx-codeblock>
Expand All @@ -42,7 +42,7 @@ pod init
source 'https://github.com/CocoaPods/Specs.git'

target 'App' do
pod 'TXLiteAVSDK_Professional'
pod 'TXLiteAVSDK_International'
end
:::
</dx-codeblock>
Expand All @@ -63,10 +63,10 @@ pod 命令执行完后,会生成集成了 SDK 的 `.xcworkspace` 后缀的工
### 手动集成
1. 下载 [LiveAVSDK](https://intl.cloud.tencent.com/document/product/1071/38150) ,下载完成后进行解压。
2. 打开您的 Xcode 工程项目,选择要运行的 target , 选中 **Build Phases** 项。
![](https://main.qcloudimg.com/raw/d78299d12be0f6c3255eabec91941e7a.jpg)
![](https://qcloudimg.tencent-cloud.cn/raw/5f0a196dd78a7858fca4f098bf3e3591.png)
3. 单击 **Link Binary with Libraries** 项展开,单击底下的【+】添加依赖库。
![](https://main.qcloudimg.com/raw/dffd804d78d3e5765add218cb228c842.png)
4. 依次添加所下载的 `TXLiteAVSDK_Professional.framework` 及其所需依赖库 :
![](https://qcloudimg.tencent-cloud.cn/raw/2e5db146788005de31337cd266315406.png)
4. 依次添加所下载的 `TXLiteAVSDK_International.framework` 及其所需依赖库 :
```
libz.tbd
libc++.tbd
Expand All @@ -75,7 +75,7 @@ libsqlite3.tbd
Accelerate.framework
OpenAL.framework
```
![](https://main.qcloudimg.com/raw/899f02c77d58f6e3b9a5d94995c767f8.png)
![](https://qcloudimg.tencent-cloud.cn/raw/35c813a543e281c7edb408d35731779b.png)
5. 选中 Build Settings 项,搜索 `Other Linker Flags`。添加 `-ObjC`。
![](https://main.qcloudimg.com/raw/818eedfb17f50f6041e84126fe4d76ed.png)

Expand All @@ -84,17 +84,17 @@ OpenAL.framework
- **Privacy - Microphone Usage Description**,并填入麦克风使用目的提示语。
- **Privacy - Camera Usage Description**,并填入摄像头使用目的提示语。

![](https://main.qcloudimg.com/raw/a924a0e1e7e7d0451dbd49cf97650dd2.jpg)
![](https://qcloudimg.tencent-cloud.cn/raw/789b7cc4c57ce32d4d3bf76d8e0199e0.png)

## 在工程中引入 SDK
项目代码中使用 SDK 有两种方式:
- **方式一:** 在项目需要使用 SDK API 的文件里,添加模块引用。
```
@import TXLiteAVSDK_Professional;
@import TXLiteAVSDK_International;
```
- **方式二:**在项目需要使用 SDK API 的文件里,引入具体的头文件。
```
#import "TXLiteAVSDK_Professional/TXLiteAVSDK.h"
#import "TXLiteAVSDK_International/TXLiteAVSDK.h"
```

## 给 SDK 配置 License 授权
Expand All @@ -104,7 +104,7 @@ OpenAL.framework
在您的 App 调用 LiteAVSDK 的相关功能之前(建议在 `- [AppDelegate application:didFinishLaunchingWithOptions:]` 中)进行如下设置:

```objc
@import TXLiteAVSDK_Professional;
@import TXLiteAVSDK_International;
@implementation AppDelegate
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
NSString * const licenceURL = @"<获取到的licenseUrl>";
Expand Down
Original file line number Diff line number Diff line change
@@ -1,250 +1,38 @@
移动直播 SDK 提供了3种版本的 SDK,了解3个版本 SDK 的关系和对应的 License 使用可参见 [功能说明](https://intl.cloud.tencent.com/document/product/1071/38149)。
移动直播 SDK 提供国际版 SDK,了解国际版 SDK 功能及其 license 使用可参见 [功能说明](https://intl.cloud.tencent.com/document/product/1071/38149)。


<h2 id="Smart">直播基础版(Smart)</h2>
<h2 id="International">国际版(International)</h2>
国际版集合了包含移动直播在内的多个音视频相关的核心功能,这包括 [实时音视频 SDK](https://intl.cloud.tencent.com/product/trtc)、直播推拉流和基础美颜能力。

基础版仅包含直播推流(TXLivePusher)和直播播放(TXLivePlayer)两项功能,对 App 的安装包体积增量最小,适合仅使用移动直播相关功能的客户。

<table>
<tr>
<th width="0px" style="text-align:center">所属平台</td>
<th width="0px" style="text-align:center">ZIP 包</td>
<th width="0px" style="text-align:center">Github</td>
<th width="0px" style="text-align:center">Gitee</td>
<th width="0px" style="text-align:center">SDK 集成指引</td>
<th width="0px" style="text-align:center">64位支持</td>
<th width="0px" style="text-align:center">安装包增量</td>
</tr>
<tr>
<td style="text-align:center">iOS</td>
<td style="text-align:center"><a onclick=MtaH5.clickStat("mlvb_sdk_download_ios_smart") href="https://liteav.sdk.qcloud.com/download/latest/TXLiteAVSDK_Smart_iOS_latest.zip">DOWNLOAD</a></td>
<td style="text-align:center"><a href="https://github.com/tencentyun/MLVBSDK">Github</a></td>
<td style="text-align:center"><a href="https://gitee.com/cloudtencent/MLVBSDK">Gitee</a></td>
<td style="text-align:center">DOC</td>
<td style="text-align:center">支持</td>
<td style="text-align:center">1.27M(arm64)</td>
</tr>
<tr>
<td style="text-align:center">Android</td>
<td style="text-align:center"><a onclick=MtaH5.clickStat("mlvb_sdk_download_android_smart") href="https://liteav.sdk.qcloud.com/download/latest/TXLiteAVSDK_Smart_Android_latest.zip">DOWNLOAD</a></td>
<td style="text-align:center"><a href="https://github.com/tencentyun/MLVBSDK">Github</a></td>
<td style="text-align:center"><a href="https://gitee.com/cloudtencent/MLVBSDK">Gitee</a></td>
<td style="text-align:center"><a href="https://cloud.tencent.com/document/product/454/7877">DOC</a></td>
<td style="text-align:center">支持</td>
<td style="text-align:center">jar:1.5M <br> so(armeabi):4.4M <br>so(armeabi-v7a):4.1M <br>so(arm64-v8a):4.9M</td>
</tr>
</table>

>? 扫码关注公众号,了解 SDK 的版本更新以及最新的技术动态。
>![](https://main.qcloudimg.com/raw/23242df893a3ecb11779a59ed9a5629c.jpg)


<h2 id="Professional">专业版(Professional)</h2>

专业版集合了包含移动直播在内的多个音视频相关的核心功能,这包括 [实时音视频 SDK](https://intl.cloud.tencent.com/product/trtc)、超级播放器(Player+)和 [短视频(UGSV)](https://intl.cloud.tencent.com/product/ugsv) 等,由于底层模块的高度复用,集成专业版的体积增量要小于同时集成两个独立的 SDK,并且可以避免符号冲突(symbol duplicate)的困恼。

<table>
<tr>
<th width="0px" style="text-align:center">所属平台</td>
<th width="0px" style="text-align:center">ZIP 包</td>
<th width="0px" style="text-align:center">Github</td>
<th width="0px" style="text-align:center">64位支持</td>
<th width="0px" style="text-align:center">安装包增量</td>
<th width="0px" style="text-align:center">安装包瘦身</td>
</tr>
<tr>
<td style="text-align:center">iOS</td>
<td style="text-align:center"><a onclick=MtaH5.clickStat("mlvb_sdk_download_ios_professional") href="https://liteav.sdk.qcloud.com/download/latest/TXLiteAVSDK_Professional_iOS_latest.zip">DOWNLOAD</a></td>
<td style="text-align:center"><a href="https://github.com/tencentyun/LiteAVProfessional_iOS">Github</a></td>
<td style="text-align:center"><a onclick=MtaH5.clickStat("mlvb_sdk_download_ios_international") href="https://liteav.sdk.qcloud.com/download/latest/TXLiteAVSDK_International_iOS_latest.zip">DOWNLOAD</a></td>
<td style="text-align:center">支持</td>
<td style="text-align:center">4.08M(arm64)</td>
<td style="text-align:center"><a href="https://intl.cloud.tencent.com/document/product/647/35165">DOC</a></td>
</tr>
<tr>
<td style="text-align:center">Android</td>
<td style="text-align:center"><a onclick=MtaH5.clickStat("mlvb_sdk_download_android_professional") href="https://liteav.sdk.qcloud.com/download/latest/TXLiteAVSDK_Professional_Android_latest.zip">DOWNLOAD</a></td>
<td style="text-align:center"><a href="https://github.com/tencentyun/LiteAVProfessional_Android">Github</a></td>
<td style="text-align:center"><a onclick=MtaH5.clickStat("mlvb_sdk_download_android_international") href="https://liteav.sdk.qcloud.com/download/latest/TXLiteAVSDK_International_Android_latest.zip">DOWNLOAD</a></td>
<td style="text-align:center">支持</td>
<td style="text-align:center">jar:1.5M<br> so(armeabi):6.5M<br> so(armv7):6.1M<br>so(arm64):7.3M</td>
<td style="text-align:center"><a href="https://intl.cloud.tencent.com/document/product/647/35165">DOC</a></td>
</tr>
</table>

>? 根据您具体使用的服务,使用专业版需先购买对应产品授权,您可按需选购:
>? 根据您具体使用的服务,使用国际版需先购买对应产品授权,您可按需选购:

>1. 使用其中的移动直播请购买 [直播推流 License(原移动直播基础版 License)](https://intl.cloud.tencent.com/document/product/1071/38114)。
>1. 使用其中的短视频请购买 短视频精简版/基础版 License。
>1. 使用其中的实时音视频请购买 [实时音视频套餐包](https://intl.cloud.tencent.com/document/product/647/34610)。

## 各版本差异对照表

![](https://main.qcloudimg.com/raw/d3c876e8d751709e1df52faf4c0bf012.jpg)

<table>
<tr>
<th width="100px" style="text-align:center">功能模块</th>
<th width="100px" style="text-align:center">功能项</th>
<th width="100px" style="text-align:center"><a href="#Smart">直播基础版</a><br>LiteAV_Smart</th>
<th width="100px" style="text-align:center"><a href="https://intl.cloud.tencent.com/document/product/1069/37914">短视频版</a><br>LiteAV_UGC</th>
<th width="100px" style="text-align:center"><a href="https://intl.cloud.tencent.com/document/product/647/34615">TRTC版</a><br>LiteAV_TRTC</th>
<th width="100px" style="text-align:center"><a href="https://intl.cloud.tencent.com/document/product/266/7836">播放器版</a><br>LiteAV_Player</th>
<th width="100px" style="text-align:center"><a href="#Professional">专业版</a><br>Professional</th>
</tr>
<tr>
<td rowspan='2' style="text-align:center">直播推流</td>
<td style="text-align:center">摄像头推流</td>
<td style="text-align:center">&#10003</td>
<td style="text-align:center">-</td>
<td style="text-align:center">-</td>
<td style="text-align:center">-</td>
<td style="text-align:center">&#10003</td>
</tr>
<tr>
<td style="text-align:center">录屏推流</td>
<td style="text-align:center">&#10003</td>
<td style="text-align:center">-</td>
<td style="text-align:center">-</td>
<td style="text-align:center">-</td>
<td style="text-align:center">&#10003</td>
</tr>
<tr>
<td rowspan='4' style="text-align:center">直播播放</td>
<td style="text-align:center">RTMP 协议</td>
<td style="text-align:center">&#10003</td>
<td style="text-align:center">-</td>
<td style="text-align:center">-</td>
<td style="text-align:center">&#10003</td>
<td style="text-align:center">&#10003</td>
</tr>
<tr>
<td style="text-align:center">HTTP - FLV</td>
<td style="text-align:center">&#10003</td>
<td style="text-align:center">-</td>
<td style="text-align:center">&#10003</td>
<td style="text-align:center">&#10003</td>
<td style="text-align:center">&#10003</td>
</tr>
<tr>
<td style="text-align:center">HLS(m3u8)</td>
<td style="text-align:center">-</td>
<td style="text-align:center">-</td>
<td style="text-align:center">-</td>
<td style="text-align:center">&#10003</td>
<td style="text-align:center">&#10003</td>
</tr>
<tr>
<td style="text-align:center">快直播(WebRTC 协议)</td>
<td style="text-align:center">-</td>
<td style="text-align:center">-</td>
<td style="text-align:center">-</td>
<td style="text-align:center">-</td>
<td style="text-align:center">&#10003</td>
</tr>
<tr>
<td rowspan='3' style="text-align:center">点播播放</td>
<td style="text-align:center">MP4 格式</td>
<td style="text-align:center">-</td>
<td style="text-align:center">-</td>
<td style="text-align:center">-</td>
<td style="text-align:center">&#10003</td>
<td style="text-align:center">&#10003</td>
</tr>
<tr>
<td style="text-align:center">HLS(m3u8)</td>
<td style="text-align:center">-</td>
<td style="text-align:center">-</td>
<td style="text-align:center">-</td>
<td style="text-align:center">&#10003</td>
<td style="text-align:center">&#10003</td>
</tr>
<tr>
<td style="text-align:center">DRM 加密</td>
<td style="text-align:center">-</td>
<td style="text-align:center">-</td>
<td style="text-align:center">-</td>
<td style="text-align:center">&#10003</td>
<td style="text-align:center">&#10003</td>
</tr>
<tr>
<td style="text-align:center">基础滤镜</td>
<td style="text-align:center">&#10003</td>
<td style="text-align:center">&#10003</td>
<td style="text-align:center">&#10003</td>
<td style="text-align:center">-</td>
<td style="text-align:center">&#10003</td>
</tr>
<tr>
<td rowspan='2' style="text-align:center">直播连麦</td>
<td style="text-align:center">连麦互动</td>
<td style="text-align:center">&#10003</td>
<td style="text-align:center">-</td>
<td style="text-align:center">&#10003</td>
<td style="text-align:center">-</td>
<td style="text-align:center">&#10003</td>
</tr>
<tr>
<td style="text-align:center">跨房 PK</td>
<td style="text-align:center">&#10003</td>
<td style="text-align:center">-</td>
<td style="text-align:center">&#10003</td>
<td style="text-align:center">-</td>
<td style="text-align:center">&#10003</td>
</tr>
<tr>
<td rowspan='2' style="text-align:center">视频通话</td>
<td style="text-align:center">双人通话</td>
<td style="text-align:center">-</td>
<td style="text-align:center">-</td>
<td style="text-align:center">&#10003</td>
<td style="text-align:center">-</td>
<td style="text-align:center">&#10003</td>
</tr>
<tr>
<td style="text-align:center">视频会议</td>
<td style="text-align:center">-</td>
<td style="text-align:center">-</td>
<td style="text-align:center">&#10003</td>
<td style="text-align:center">-</td>
<td style="text-align:center">&#10003</td>
</tr>
<tr>
<td rowspan='4' style="text-align:center">短视频</td>
<td style="text-align:center">录制和拍摄</td>
<td style="text-align:center">-</td>
<td style="text-align:center">&#10003</td>
<td style="text-align:center">-</td>
<td style="text-align:center">-</td>
<td style="text-align:center">&#10003</td>
</tr>
<tr>
<td style="text-align:center">裁剪拼接</td>
<td style="text-align:center">-</td>
<td style="text-align:center">&#10003</td>
<td style="text-align:center">-</td>
<td style="text-align:center">-</td>
<td style="text-align:center">&#10003</td>
</tr>
<tr>
<td style="text-align:center">“抖音”特效</td>
<td style="text-align:center">-</td>
<td style="text-align:center">&#10003</td>
<td style="text-align:center">-</td>
<td style="text-align:center">-</td>
<td style="text-align:center">&#10003</td>
</tr>
<tr>
<td style="text-align:center">视频上传</td>
<td style="text-align:center">-</td>
<td style="text-align:center">&#10003</td>
<td style="text-align:center">-</td>
<td style="text-align:center">-</td>
<td style="text-align:center">&#10003</td>
</tr>
</tr>
</table>



<script>
var _mtac = {"senseHash":0};
Expand Down