Source Type: Binary SDK Charge Type: free of charge
This document is intended for all developers and testers who use KSY Live iOS SDK, and requires readers to have some experience in iOS programming and development, and require readers to read wiki habits.
|
|
|
|
|
|
|
KSY Live iOS SDK Jinshan Cloud provides live solution as part of the completion of the iOS audio and video data acquisition, processing, streaming and playback.
KSY Live iOS SDK does not limit the user's push, pull flow address. Users can only use KSY Live iOS SDK instead of using Jinshan cloud services.
KSY Live iOS SDK does not charge any license fee, does not contain any lapse of time or shut down the back door remotely. At the same time KSY Live iOS SDK does not require ak / sk authentication, there is no user identification information.
KSY Live iOS SDK provides industry-leading H.265 encoding and decoding capabilities, H.265 capabilities are free to use, welcome to integration trial.
KSY Live iOS SDK Currently does not provide open source code, if you need other custom development features, please contact Kingsoft Business Channel.
Kingsoft Cloud guarantees, KSY Live SDK does not use any hot update technology, such as: RN (ReactNative), weex, JSPatch, etc.
- AAC Audio Encoding (Soft and Hard)
- H.264 video encoding (soft / hardcode supported, baseline / main / high profile supported)
- H.265 Video Soft Coding
- H.264 video coding (support for soft editing H.264 / H.265 support for H.264 hard coding (baseline / main / high profile support)
- Multi-resolution encoding support
- Camera Controls (Toward, Flash, Front and Rear Cameras)
- Camera Control (native system api can be called)
- User can freely set audio and video bit rate
- Adjust the video bit rate adaptively according to the network bandwidth. The network adaptation mode can be configured
- Support RTMP streaming live streaming
- Provides two levels of APIs: easy-to-use kit APIs and flexible component-based APIs that provide open source kit class code
- Seamless integration with GPUImage
- Built-in Beauty Filters for GPU Implementation
- Support Background Music Play
- Support Remix
- Support Video Motion Switch / Audio Streaming
- Support Backstage
- Support Ear Back
- Support PIP Streaming
- support preview and capture resolution set separately, support for any resolution
- Support 3rd party with wheat
- Scene Code
- Support for soft and hard coded Performance Coding Mode
- Support Preview & Stream respectively
- Online API Documentation Support
- Support Sidebar, save the video file during the streaming
- Support Stereo Streaming (2-channel)
- Support Doodle Streaming
- Support for Desktop Recording, Live Tour
- Consistent with the system player MPMoviePlayerController interface, seamless and fast switching to KSYMediaPlayer;
- Native full media format support, optimized for mainstream media formats (mp4, avi, wmv, flv, mkv, mov, rmvb, etc)
- Support for a wide range of streaming video formats, HLS, RTMP, HTTP Pseudo-Streaming, etc;
- low latency live experience, with Jinshan cloud streaming sdk, you can achieve full live broadcast 4 seconds delay stability;
- Achieve fast full screen playback, to bring users faster and better quality playback experience;
- version adapter supports iOS 7.0 and above;
- Industry-leading H.265 decoding;
- Ultra-lightweight live sdk less than 2M;
Kingsoft Cloud SDK guarantees that the provided KSYLive iOS Live Broadcast SDK does not use thermal update technologies such as RN (ReactNative), weex, JSPatch, etc., so be sure to use it.
Kingsoft Cloud SDK guarantees that the provided KSYLive iOS Live Broadcast SDK can be used for commercial applications without charge for any SDK usage. However, other commercial services based on the KSYLive iOS Live Broadcast SDK will be charged by a specific vendor for licensing fees, broadly including:
Cloud storage CDN distribution
- Dynamic stickers
- Even wheat
- Third-party beauty
- 2016.02.25 uplink network adaptive on-line;
- 2016.03.26 Built-in beauty On the line;
- 2016.04.11 Voice that supports four reverb modes is online;
- 2016.05.18 Ear Return Go live;
- 2016.06.12 PIP Streaming on the line;
- 2016.06.27 support short video recording;
- 2016.08.24 Support Pure Audio Streaming, support [Backstage](https://github.com/ksvc/KSYLive_iOS/wiki / backgroupStream), support video dynamic send switch;
- 2016.08.31 Scenario Code to effectively enhance the live video quality;
- 2016.09.07 Built-in new beauty on the line;
- 2016.09.12 kit class top-level code open source, podspec integrated framework will be changed to integrated static library
- 2016.09.21 special effects filter on the line;
- 2016.09.26 double with wheat stable version on the line;
- 2016.09.28 Video Hardcoding Performance Encoding Mode Go live. Audio AAC hard-coded features on the line. Network adaptive scene on the line;
- 2016.10.19 Support Live Streaming Dynamics;
- 2016.10.20 Support replaykit 屏 屏 流流;
- 2016.11.18 Support Record as mp4 file while streaming
- 2016.2.22 Support Dynamic Frame Rate
- 2016.3.1 support anchor audio Acquisition voice
- 2017.3.14 Support Stereo Streaming
- 2017.5.16 Support Graffiti streaming
- 2017.7.7 Support Desktop Recording, Live Streaming
- 2017.7.7 Support iOS 11 HEVC Streaming
- 2017.8.3 support to collect noise reduction
- 2017.03.xx multi-view live;
- 2017.03.xx background noise reduction;
- Minimum iOS version supported: iOS 7.0
- Minimum support iPhone model: iPhone 4
- Support CPU architecture: armv7, armv7s, arm64 (and i386, x86_64 emulator)
- Contains i386 and x86_64 emulator version of the library file, streaming function can not work on the simulator, playback fully support simulator.
The SDK provides the following access methods:
3.2.1 from github clone
The directory structure is as follows:
- demo: The demo project is KSYLive, which demonstrates the use of the SDK's main interface
- doc / docset: appleDoc-style interface document, installed in xcode can see the method and properties of the document
- doc / html: AppleDoc-style web interface documentation, but also view the online version
- prebuilt: precompiled library header and library files
- source: Kit kit source code
- releaseFramework: Scripts and projects for packaging a precompiled library into an easy-to-integrate framework
$ git clone https://github.com/ksvc/KSYLive_iOS.git KSYLive_iOS --depth 1
3.2.2 From bitbucket clone
For some places to visit slower github circumstances, you can get from the bitbucket clone library content and github consistent.
$ git clone https://bitbucket.org/ksvc/ksylive_ios.git --depth 1
By using Cocoapods, you can download the static library and code of this SDK locally just by adding a sentence similar to the following sentence to your Podfile:
pod 'libksygpulive / KSYGPUResource'
pod 'libksygpulive / libksygpulive'POD install can be implemented.
Among them, the first paragraph libksygpulive SDK name, the second paragraph KSYGPUResource and libksygpulive sub-module name
This SDK provides a number of different sub-modules to meet the needs of different users:
- KSYMediaPlayer: for broadcast live kernel (support for streamlined format)
- KSYMediaPlayer_vod: for on-demand playback kernel (rich format support)
- libksygpulive: SDK for live streaming and playback (Streaming Streaming and Streaming SDK)
- libksygpulive_265: SDK for Streaming and Playback on Streaming (supports Streaming and Streaming SDKs)
- KSYGPUResource: streaming media resources used in the main file, mainly for beauty and special effects filters
Pod Dependencies
* Local development version (sdk clone or download to the local)pod 'libksygpulive / libksygpulive',: path => '../'
- Directly specify the SDK's github repository address and version number
pod 'libksygpulive / libksygpulive',: git => 'https://github.com/ksvc/KSYLive_iOS.git' ,: tag => 'v1.8.0'
Get spec from cocoapod official library trunk, download sdk from github
pod 'libksygpulive / libksygpulive'
- Get spec from cocoapod official library Trunk, download sdk from Kingsoft cloud storage ks3 (domestic speed is faster)
pod 'libksygpulive_ks3 / libksygpulive'
- If pod install can not find the prompt of specification, please update repo first
pod repo update
- Note 1: The above statements can not be added to the Podfile, their role is the same, but Podspec read different locations.
Please refer to GPUImage provided by the official cocoapods. The current version of our test is [0.1.7](https: // github. com / BradLarson / GPUImage / releases / tag / 0.1.7)
!!!!! Note: Here are two ways to run the demo, but only one alternative; If you want to change another method, please re-download or decompression, or restore git repository before trying. !!!!!
There is already a Podfile in the demo directory that specifies the local development version of the pod In the demo directory, execute the following command, you can start to compile and run the demo
$ cd demo
$ pod install
$ open KSYLiveDemo.xcworkspace
note: After updating the pod, you need to open xcwrokspace instead of xcodeproj
- SDK package as framework
Unzip the archive (or clone successfully), enter the releaseFramework directory, download the dependencies via release-libKSYLive.sh and package out the framework, generated to KSYLive_iOS / framework / static directory.
$ cd releaseFramework
$ ./release-libKSYLive.sh libksygpulive lite
$ ls ../framework/static
Bugly.framework GPUImage.framework libksygpulive.framework
Please refer to the help of the script release-libKSYLive.sh (./release-libKSYLive.sh -h) or [Dynamic Library Point 4] for details on the parameters (https://github.com/ksvc/KSYLive_iOS/wiki/dylib ).
Bugly.framework is to collect the demo's crash letter
- SDK package as framework
Unzip the archive (or clone successfully), enter the releaseFramework directory, download the dependencies via release-libKSYLive.sh and package out the framework, generated to KSYLive_iOS / framework / static directory.
$ cd releaseFramework
$ ./release-libKSYLive.sh libksygpulive lite
$ ls ../framework/static
Bugly.framework GPUImage.framework libksygpulive.framework
Please refer to the help of the script release-libKSYLive.sh (./release-libKSYLive.sh -h) or [Dynamic Library Point 4] for details on the parameters (https://github.com/ksvc/KSYLive_iOS/wiki/dylib ).
Bugly.framework is used to collect demo crashes (used in demo only) Bugs are not dependent on integrating the SDK into user projects.
- Add library dependencies to demo
Open the demo directory KSYLiveDemo.xcodeproj, modify the configuration file of the KSYLiveDemo project: Select KSYLiveDemo project -> select Project KSYLiveDemo-> select Info tab -> select Configurations-> Debug or Release-> to KSYLiveDemo respectively select the corresponding KSYLiveDemo-framework.xcconfig file. Note that if using a dynamic library, select KSYLiveDemo-dy-framework.xcconfig.
Or manually add the following parameters in the project configuration: (For details, see KSYLiveDemo-framework.xcconfig in the demo directory)
OTHER_LDFLAGS = $ (inherited) -ObjC -all_load -framework libksygpulive -framework GPUImage -framework Bugly -lstdc ++. 6 -lz
FRAMEWORK_SEARCH_PATHS = $ (inherited) ../framework/ ../framework/static
The above is the integration method of the static library. For the configuration and usage of the dynamic library, please refer to the content of Dynamic Library in the Wiki.
#import <GPUImage / GPUImage.h>
#import <libksygpulive / KSYGPUStreamerKit.h>
The above two header files need to be introduced:
-
GPUImage.h because of reliance on third-party framework needs to be introduced
-
KSYGPUStreamerKit.h is open top kit class kit class can be used directly, you can also modify
-
When you need to customize GPUImage, the version of GPUImage is 0.1.7
The SDK version number mainly through the core class query
NSLog (@ "version:% @", [streamerBase getKSYVersion]);
NSLog (@ "version:% @", [kit getKSYVersion]);
- This framework already includes Play SDK And will have a conflict with the playback SDK, before integration, please ensure that the previously integrated KSY playback SDK is removed
- This framework may conflict with other static libraries that use FFmpeg (conflict may consider using dynamic libraries)
- This framework is a static library, although the size of the library is 20M +, but after the last link, the increment of the app is only 5M +
- If you use the cocoapod official library Trunk and found that you can not find the latest version of the library, you need to execute the following command to update the spec library
pod repo update
- iOS Streaming SDK User Guide
- iOS Live Streaming SDK Frequently Asked Questions
- Interface Change History
See the github library at https://github.com/ksvc/KSYMediaPlayer_iOS.git
| Type | Description | |: ---: |: ---: | | SDK Name | KSYLive_iOS | | SDK Version | v2.5.0 | | Equipment model | iphone7 | | OS Version | iOS 10 | | Problem Description | Description of the problem | | Description of Operation | Describes what went wrong with this operation | | Extra Attachments | Textual Forms Console log, crash reports, other ancillary information (screen shots or videos, etc.) |
- Homepage: Jinshan cloud
- E-mail: zengfanping@kingsoft.com
- QQ discussion group: * 574179720 [video cloud technology exchange group] * 621137661 [video cloud iOS technology exchange] * Add more than one QQ group can be
- Issues: https://github.com/ksvc/KSYLive_iOS/issues
