apiAdjust

接口变动历史

v1.8.0

• release note: https://github.com/ksvc/KSYLive_iOS/releases/tag/v1.8.0

• 版本发布方式变更:

  1. 由原来的单个framework的发布 改为 多个静态库和头文件的发布方式(可根据需要灵活组合)
  2. 提供带配置参数的脚本文件 releaseFramework/release-libKSYLive.sh, 根据参数配置生成framework
  3. Podspec 名称变更为libksygpulive, 并增加了submodule, 通过指定不同的submodule来满足不同应用场景的需求

• kit类的源代码开放
  kit类主要作用有两个:

  1. 将积木类进行组合, 能够满足简单推流场景的需求, 简单易用
  2. 作为积木类API使用的范例, 方便用户定制开发

• 新增图像混合类 KSYGPUPicMixer

• 新增AVAudioSession工具类 KSYAVAudioSession

  • 以前与音频的采集播放相关的接口都挪到这个类中了, 比如
  • kit.bInterruptOtherAudio 属性挪到了 kit.avAudioSession.bInterruptOtherAudio 中
  • 另外,kit类提供了initWithInterruptCfg 和initWithDefaultCfg, 对应构造bInterruptOtherAudio属性为YES和NO的kit实例

• kit类分辨率设置接口变更 参见

  • 新的设置方法:
  1. 采集分辨率 直接使用 Apple定义的preset
  2. 预览和推流分辨率直接通过CGSize指定, 通过GPU进行裁剪和缩放

v1.7.1

• release note: https://github.com/ksvc/KSYLive_iOS/releases/tag/v1.7.1

删除接口

/**
 @abstract   是否将视频数据送入streamer (默认为NO)

 @see streamer
 */
@property BOOL  bStreamVideo;

/**
 @abstract   是否将音频数据送入streamer (默认为YES)
 
 @see streamer
 */
@property BOOL  bStreamAudio;

调整接口

• 在V1.7.1之前采集接口

/**
 @abstract   获取开始推流后的采集设备

 @discussion 通过该指针可以对摄像头进行操作
 */
@property (nonatomic, readonly) KSYGPUCamera*   capDev;

• 在1.7.1调整为

/**
 @abstract   视频采集设备

 @discussion 通过该指针可以对摄像头进行操作 (操作接口参见GPUImage)
 */
@property (nonatomic, readonly) KSYGPUCamera       *capDev;

使用方法：
    初始化：
    _capDev = [[KSYGPUCamera alloc] initWithSessionPreset:_capPreset
                                            cameraPosition:_cameraPosition];
    视图输出方向
    _capDev.outputImageOrientation = UIInterfaceOrientationPortrait;
    开始采集
    [_capDev startCameraCapture];
    摄像头原始数据回调
    _capDev.videoProcessingCallback = ^(CMSampleBufferRef but){

    };
    停止采集
    [_capDev      stopCameraCapture];

/**
 @abstract  音频采集设备 Audio Unit 音频采集
 */
@property (nonatomic, readonly) KSYAUAudioCapture      *audioCapDev;

使用方法：
    初始化音频采集模块
    _audioCapDev = [[KSYAUAudioCapture alloc] init];
    音频采集, 语音数据送入混音器
    _audioCapDev.audioProcessingCallback = ^(CMSampleBufferRef buf){
        [kit mixAudio:buf to:KSYMicTrack];
    };
    开始采集
    [_audioCapDev startCapture];

v1.7.0

• release note: https://github.com/ksvc/KSYLive_iOS/releases/tag/v1.7.0

新增接口

/**
 @abstract   本次直播的目标场景 (默认为KSYLiveScene_Default)

 @discussion KSY内部会根据场景的特征进行参数调优,开始推流前设置有效
 */
@property (nonatomic, assign) KSYLiveScene              liveScene;
/**
 @abstract   视频编码性能档次 ( 默认为 KSYVideoEncodePer_LowPower)

 @discussion 视频质量和设备资源之间的权衡,开始推流前设置有效
 */
@property (nonatomic, assign) KSYVideoEncodePerformance videoEncodePerf;

• 新增接口使用方法：https://github.com/ksvc/KSYLive_iOS/wiki/liveScene