ksyairstreamer_ios's Introduction

KSYAirStreamer iOS SDK

Source Type: Binary SDK
Charge Type: nonfree

一. 功能特性

金山云录屏直播SDK是金山云提供的直播解决方案的一部分，完成了iOS端全屏录制的功能，主要实现思路是本SDK内实现了一个Airplay的接收端, 开始录屏时iOS系统与SDK建立连接, SDK收到画面后, 编码发送到直播服务器. 其中编码和推流功能使用金山云直播SDK实现.

可以用于手游等直播录制场景。

1.1 录屏功能

支持iOS8/9/10/11录屏
硬解/软解支持
动态横竖屏支持
固定横屏/竖屏支持

1.2 关于上架

根据Apple的政策, 含有Airplay功能的APP无法通过App Store审查, 请注意.

1.3 费用

当前版本使用联网解密，因为网络原因或者服务器抖动，会导致录屏失败。当前评估版本可以免费集成和试用。本评估版本不限制使用并发数。

请勿集成并上线，因为网络原因导致的功能不可用，[金山云][ksyun]不承担任何责任。

1.3.1 购买

如果需要商业使用，请登录金山云魔方控制台获取离线解密版本。离线版本使用过程中不会发生联网行为，可以稳定用于商业应用。

商业版本费用，请参考金山云魔方控制台报价。

二. SDK集成方法介绍

2.1 系统要求

最低支持iOS版本：iOS 8.0
最低支持iPhone型号：iPhone 5
支持CPU架构： armv7,arm64(和i386,x86_64模拟器)
含有i386和x86_64模拟器版本的库文件，录屏和推流功能无法在模拟器上工作

2.2 下载工程

本SDK 提供如下列出获取方式:

2.2.1 从github clone

目录结构如下所示:

demo : demo工程演示本SDK的主要接口的使用
docs/html : appleDoc风格的网页版接口文档
prebuilt : 预编译库的头文件和库文件
source : 顶层kit类的源代码

$ git clone https://github.com/ksvc/KSYAirStreamer_iOS.git --depth 1

2.2.3 使用Cocoapods 进行安装

通过Cocoapods 能将本SDK的静态库和代码下载到本地，只需要将类似如下语句中的一句加入你的Podfile：

pod 'libksygpulive', '~> 2.4.0'
pod 'KSYAirStreamer', '~> 0.1.0'

2.3 开始运行demo工程

demo 目录中已经有一个Podfile, 指定了本地开发版的pod
在demo目录下执行如下命令, 即可开始编译运行demo

$ cd demo
$ pod install
$ open KSYAirStreamer.xcworkspace

注意:

更新pod之后, 需要打开 xcwrokspace, 而不是xcodeproj

2.4 添加头文件到需要使用本SDK的文件中

#import <KSYAirStreamer/KSYAirStreamKit.h>

2.5 SDK版本号查询

本SDK的版本号主要通过头文件查询

#define KSYAIRSTREAMER_VER  0.1.0

三. 参考文档

wiki: https://github.com/ksvc/KSYAirStreamer_iOS/wiki
API 文档: https://ksvc.github.io/KSYAirStreamer_iOS/html/index.html

四. 反馈与建议

主页：金山云
邮箱：[email protected]
QQ讨论群：
- 574179720 [视频云技术交流群]
- 621137661 [视频云iOS技术交流]
- 以上两个加一个QQ群即可
Issues:https://github.com/ksvc/KSYAirStreamer_iOS/issues

ksyairstreamer_ios's People

Contributors

Stargazers

Watchers

ksyairstreamer_ios's Issues

while i try to connect the server but I couldn't do this. How to connect RTMP Server

stream state KSYStreamStateError
error code KSYStreamErrorCode
video codec open failed, try software codec

Eliminating the need for manually select the device?

(Translated to english)

The use of KSYAirStreamer screencast, eliminating the need for users to manually select the device, because we already know the name of the device, you can take the initiative to select the corresponding device

Can you please elaborate, how exactly do I automatically connect to a device without prompting the user to manually select the device name ? Thanks.

Unable to connect to airplay KSYAirErrorCodeConnectFailed

Hi, Since last week we are facing this issue with airplay mirroring, where we are getting this error: "KSYAirErrorCodeConnectFailed". We haven't faced this issue, and there seems to be no explanation for this error available anywhere. The connection to airplay is now consistently failing.

Can anyone help here?

Error:
Error Domain=com.ksyun.ios.ksyairerror Code=3 "KSYAirErrorCodeConnectFailed" UserInfo={NSLocalizedDescription=KSYAirErrorCodeConnectFailed}

ksvc / ksyairstreamer_ios Goto Github PK