Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

金山云直播SDK [ iOS推流+播放 ]融合版 支持美颜滤镜(Beauty Filter)、美声(Beauty Voice)、软硬编(Software/Hardware Encoder) 、网络自适应(Network Auto Adapt)、混音(Voice Mixer)、混响(Reverb)、画中画(PIP)

Notifications You must be signed in to change notification settings

MusketeerTeam/KSYLive_iOS

Repository files navigation

一. 功能特性

1.1 推流功能

1.2 文档

详情请见wiki

1.3 播放特点

  • 与系统播放器MPMoviePlayerController接口一致,可以无缝快速切换至KSYMediaPlayer;
  • 本地全媒体格式支持, 并对主流的媒体格式(mp4, avi, wmv, flv, mkv, mov, rmvb 等 )进行优化;
  • 支持广泛的流式视频格式, HLS, RTMP, HTTP Rseudo-Streaming 等;
  • 低延时直播体验,配合金山云推流sdk,可以达到全程直播稳定的4秒内延时;
  • 实现快速满屏播放,为用户带来更快捷优质的播放体验;
  • 版本适配支持iOS 7.0以上版本;
  • 业内一流的H.265解码;
  • 小于2M大小的超轻量级直播sdk;

二. 推流端大事记

2.1 2016年发布大事记

  1. 2016年02月25日 上行网络自适应上线;
  2. 2016年03月26日 内建美颜上线;
  3. 2016年04月11日 支持四种混响模式的美声上线;
  4. 2016年05月18日 耳返上线;
  5. 2016年06月12日 画中画推流上线;
  6. 2016年06月27日 支持短视频录制;
  7. 2016年08月04日 两人连麦内测;
  8. 2016年08月24日 支持纯音频推流,支持后台音频推流,支持视频动态发送开关;

2.2 近期工作

  1. 2016.09.xx kit顶层库代码开源;
  2. 2016.09.xx 内建极致美颜上线;
  3. 2016.09.xx 高达50% cpu性能节省的场景编码上线;

三. SDK集成方法介绍

3.1 系统要求

  • 最低支持iOS版本:iOS 7.0
  • 最低支持iPhone型号:iPhone 4
  • 支持CPU架构: armv7,armv7s,arm64(和i386,x86_64模拟器)
  • 含有i386和x86_64模拟器版本的库文件,推流功能无法在模拟器上工作,播放功能完全支持模拟器。

3.2 下载工程

本SDK 提供如下三种获取方式:

3.2.1 从github clone

目录结构如下所示:

  • demo : demo工程为KSYLive ,演示本SDK的主要接口的使用
  • doc/docset : appleDoc风格的接口文档,安装后可在xcode中直接看到方法和属性的文档
  • doc/html : appleDoc风格的网页版接口文档,也可查看在线版
  • framework/livegpu/libksygpulive.framework : 本SDK的静态库framework,集成时需要将该framework加入到项目中
$ git clone https://github.com/ksvc/KSYLive_iOS.git KSYLive_iOS

3.2.2 从oschina clone

对于部分地方访问github比较慢的情况,可以从oschina clone,获取的库内容和github一致。

$ git clone https://git.oschina.net/ksvc/KSYLive_iOS.git

3.2.3 使用Cocoapods 私有库进行安装

通过Cocoapods 能将本SDK的静态库framework下载到本地,只需要将如下语句加入你的Podfile:

pod 'KSYGPULive_iOS', :git => 'https://github.com/ksvc/KSYLive_iOS.git'

执行 pod install 或者 pod update后,将SDK加入工程。

3.2.4 使用Cocoapods 官方库进行安装

配置工程Podfile文件,添加KSYGPULive_iOS配置信息

pod 'KSYGPULive_iOS'

3.3 添加framework到工程中

  • SDK压缩包 将压缩包中framework下的libksygpulive.framework添加到XCode的工程,具体步骤为:
  1. 选中应用的Target,进入项目配置页面
  2. 切换到 Build Phases标签页
  3. 在Link Binary With Libraries 一栏中加入 libksygpulive.framework和第三方依赖库GPUImage.framework
  • SDK Cocoapods 在Podfile中本SDK的条目,并执行了 pod install 之后, 本SDK就已经加入工程中,打开工程的workspace即可。

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

#import <GPUImage/GPUImage.h>
#import <libksygpulive/libksygpulive.h>
#import <libksygpulive/libksygpuimage.h>

以上三个头文件都是需要引入的:

  • GPUImage.h是因为依赖第三方framework需要引入的
  • libksygpulive.h 是本SDK中不依赖 GPUImage部分的头文件
  • libksygpuimage.h 是依赖GPUImage部分的头文件
  • 当自定义GPUImage时,GPUImage的版本要求是0.1.7

3.5 SDK版本号查询

本SDK的版本号 主要通过核心类查询

NSLog(@"version: %@", [streamerBase getKSYVersion]);
NSLog(@"version: %@", [kit getKSYVersion]);

3.6 集成时的注意事项

  • 本framework已经包含播放SDK
    且会跟播放SDK产生冲突,在集成前,请先保证将之前集成的KSY播放SDK移除
  • 本framework可能与其他使用了FFmpeg的静态库冲突
  • 本framework为静态库,虽然库的大小为20M+,但是最后链接后,对app的增量只有4M+

四. 参考文档

五. 播放器使用示例

请见github库:https://github.com/ksvc/KSYMediaPlayer_iOS.git

六. 反馈与建议

About

金山云直播SDK [ iOS推流+播放 ]融合版 支持美颜滤镜(Beauty Filter)、美声(Beauty Voice)、软硬编(Software/Hardware Encoder) 、网络自适应(Network Auto Adapt)、混音(Voice Mixer)、混响(Reverb)、画中画(PIP)

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Objective-C 96.4%
  • C 3.1%
  • Ruby 0.5%

AltStyle によって変換されたページ (->オリジナル) /