CWSSDK 3.2.0
- 作者
- cloudwings
日期：2017年10月18日
修订版本：3.2.0
变更日志
- 3.2.0
将Shake代理超时回调合并到失败回调。
增加了更多注释。
- 3.1.1
修复了Xcode 9阻塞警告。
- 3.0.1
合并了标签和Fp。
- 2.3.2
修复了标签算法识别错误。
- 2.3.1
修复了标签算法内存泄露。
- 2.3.0
移除了旧算法。
- 2.2.0
修复了重试错误。
- 2.1.0
名称已更改。
- 2.0.3
修复了fp崩溃错误。
- 2.0.2
修复了存档错误：由于未构建全符号，无法生成位代码存档。
- 2.0.0
破坏性API更改。
- 1.0.21
次要更新。
- 1.0.20
相互兼容和不兼容混合。
- 1.0.19-c
兼容旧音频标签算法。
- 1.0.19
次要优化。
- 1.0.18
不再支持旧音频标签算法。
- 1.0.6
支持新的音频标签算法。
- 1.0.4
支持IPv6生产环境。
- 1.0.3
添加IPv6支持（仅限于实验性使用，请不要在生产环境中使用）
- 1.0.2
添加IPv6支持（仅限于实验性使用，请不要在生产环境中使用）
- 1.0.1
CWSSDK接口更新。
前言
本文档演示了如何将CWSShakeSDK集成到您的iOS项目中。
SDK
版本: 3.2.0
描述：SDK提供ACR（自动内容识别）功能，允许第三方应用通过监听音频源检索用户定义的内容。
先决条件
语言：Objective-C
IDE：XCode
凭据：appId和appSecret
安装
手动
- 下载 CWSShakeSDK_iOS_3.2.0.zip并解压。您将得到以下文件
- CWSShakeSDK.framework：链接到您的iOS项目的框架文件。
- ShakeSDKDemo：已集成SDK的示例iOS应用项目。
- iOS_CWSShakeSDK_Integration_Manual.pdf：集成手册。
-
将 CWSShakeSDK.framework 复制到您的项目文件夹中，并将其添加到您的项目中。
-
创建一个新的复制文件阶段，并将框架文件作为框架复制。
在项目视图中，单击 构建阶段 > 左上角的加号 > 新建复制文件阶段
将目标切换到 框架 并添加 CWSShakeSDK.framework 文件
使用
- 导入SDK头文件。
#import <CWSShakeSDK/CWSShakeSDK.h>
- 使您的视图控制器扩展CWSShakeViewController。
@interface ViewController : CWSShakeViewController
- 使您的视图控制器或其他对象符合CWSShakeDelegate并实现定义在代理中所有必需的方法。
CWSShakeDelegate是SDK中定义的协议。声明如下
@protocol CWSShakeDelegate <NSObject>
@optional
- (void)shakeControllerPermissionDenied:(CWSShakeViewController *)controller;
@required
- (BOOL)shakeControllerCanShake:(CWSShakeViewController *)controller;
- (void)shakeControllerDidShake:(CWSShakeViewController *)controller;
- (void)shakeController:(CWSShakeViewController *)controller didSucceedWithUserContent:(CWSUserContent *)userContent;
- (void)shakeControllerDidCancel:(CWSShakeViewController *)controller;
- (void)shakeController:(CWSShakeViewController *)controller didFailWithError:(CWSError *)error;
符合此协议
@interface ViewController () <CWSShakeDelegate>
将代理设置到视图控制器
self.shakeDelegate = self;
- 调用SDK的 requestPermission 方法以从用户请求所需的权限。
[CWSShakeManager requestPermission];
- 在使用SDK的其他任何功能之前，使用您的 appId 和 appSecret 调用 register 方法。
[CWSShakeManager registerWithAppId:APP_ID appSecret:APP_SECRET success:^{
} failure:^(CWSError *error) {
}];
-
将 NSMicrophoneUsageDescription 添加到您的项目 Info.plist 文件中。请注意，当用户触发摇动事件时，我们的 SDK 会使用麦克风。并且在 Info.plist 中添加上述键值对是必要的。否则，应用程序将无法运行。
-
在真实 iOS 设备或仿真器中编译并运行应用程序。您可能需要一个演示视频来测试 ACR 功能。请参阅以下网站获取演示视频：https://shake2buy.com
