腾讯云X-P2P接入说明_音视频解决方案_同尘科技
腾讯云 X-P2P 解决方案,可帮助用户直接使用经过大规模验证的直播、点播、文件分发服务,通过经商用验证的 P2P 服务大幅节省带宽成本,提供更优质的用户体验。开发者可通过 SDK 中简洁的接口快速同自有应用集成,实现 iOS 设备上的 P2P 加速功能。传统 CDN 加速服务中,客户端向 CDN 发送 HTTP 请求获取数据。在腾讯云 X-P2P 服务中,SDK 可以视为下载代理模块,客户端应用将 HTTP 请求发送至 SDK,SDK 从 CDN 或其他 P2P 节点获取数据,并将数据返回至上层应用。SDK 通过互相分享数据降低 CDN 流量,并通过 CDN 的参与,确保了下载的可靠性。
SDK 名称 | XP2P iOS 端 SDK |
版本号 | V1.3.5 |
SDK 介绍 | 为直播、点播、下载等场景的内容分发网络提供P2P点到点对等网络内容共享加速 |
开发者 | 腾讯云计算(北京)有限责任公司 |
个人信息处理规则 | XP2P SDK 隐私保护协议 |
下载 SDK | 单击下载 iOS SDK压缩包 |
说明 SDK 支持多实例,即支持同时开启多个直播 P2P。
支持的架构
当前 iOS SDK 支持如下 ABI 架构:armv7armv7sarm64x86x86_64
集成 SDK
通过 CocoaPods 集成
1. 在项目根目录创建 Podfile 文件。
platform :ios, '9.0'target 'RTMPiOSDemo' do #这里需要修改成自己的target工程 use_frameworks! pod 'xnet', :git => 'https://github.com/tencentyun/xnet-ios-sdk.git', :tag => "release-lastest"end
2. 在 Terminal 中执行以下命令。
pod install
如果您是更新版本请执行:
pod update
3. 打开 workspace:
open RTMPiOSDemo.xcworkspace #您需要打开自己的xcworkspace
通过 framework 集成
1. 拷贝 X-P2P 团队提供的 xnet.framework
。2. 直接通过 Xode -> General -> "Framework, Libraries, and Embedded Content"
添加 xnet.framework
。
配置应用
腾讯云对接人员会提供 iOS 项目的 Bundle identifier,并索取 App ID
、App Key
、App Secret Key
,如以下形式:
Bundle identifier:com.qcloud.helloworldNSString *appID = @"your_appID";NSString *key = @"your_key";NSString *secret = @"your_secret";
接入步骤
1. 解压 TencentXP2P.zip
文件得到 TencentXP2P.framework
,并在项目中引用。2. 在 App 启动时初始化 XP2PModule
,并随后初始化 P2P SDK。
// Example: 程序的入口AppDelegate.m #import "AppDelegate.h" #import @implementation AppDelegate - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { // do something other...
//下面的接口调用可以开启SDK log的打印,不调用该接口,log打印默认不开启 [XNet enableDebug]
NSString *appID = @"your app id"; NSString *key = @"your app key"; NSString *secret = @"your app secret"; bool ok = [XNet initWith:appID appKey:key appSecretKey:secret];
return YES; }
- (void)onLogPrint:(NSString*)msg { //这里能够收到SDK输出的日志 }
@end
3. 加载一个频道。
- (int)startPlay:(NSString*)url { // 将resource之前的 域名/路径 内容替换为 [XP2PModule host] 即可,例如 // 原先是,http://example.cdn.com/live/streamid.flv?token=xxx // 转换成,http://127.0.0.1:16080/live.p2p.com/example.cdn.com/live/streamid.flv?token=xxx NSString* p2pUrl = [url stringByReplacingOccurrencesOfString:@"http://" withString: [XNet proxyOf:@"live.p2p.com"]]; NSString *codecID = @"_h265"; NSString *stremaid = [[url lastPathComponent] stringByDeletingPathExtension]; NSString *xresid = [NSString stringWithFormat:@"%@_%@", stremaid, codecID]; NSString* param = [NSString stringWithFormat:@"?xresid=%@", xresid]; p2pUrl = [p2pUrl stringByAppendingString:param]; // 直接播放此url即可 [_player startPlay:p2pUrl]; return EXIT_SUCCESS; }
卸载一个频道。
- (int)stopPlay { // 播放器链接断开以后 SDK内部会自动释放频道相关的资源, 直接关闭播放器即可 [_player stopPlay]; return EXIT_SUCCESS; }
4. 恢复前台显示时,必须调用 resume。否则在播放器暂停阶段 iOS 会关闭链接,此时向代理发起请求,会收到类似502的错误。
bool ok = [XNet resume];
注意事项
以上是一个播放器使用 P2P 的基本调用,完成上述调用后您就可以使用 P2P 为播放器提供服务了,但一个更加完善的客户端还需要做以下工作:统计流量,获取 SDK 运行过程中的 P2P 流量和 CDN 流量。监听网络变化,在移动网络显示 P2P 上传,WIFI 网络开启 P2P 上传(默认开启)。这些设置您需要以 HTTP 请求的方式告知 SDK 代理服务,调用 API 请参见 API 说明。
对音视频的解决方案有疑惑?想了解解决方案收费? 联系解决方案专家
腾讯云限时活动1折起,即将结束: 马上收藏
同尘科技为腾讯云授权服务中心,购买腾讯云享受折上折,更有现金返利:同意关联,立享优惠
阿里云解决方案也看看?: 点击对比阿里云的解决方案
暂无评论,你要说点什么吗?