HIFIVE 音加加提供曲库、评分、修音功能的 K 歌 SDK-iOS 版本

功能说明：

KXKTVSDK 整合了歌词展示、演唱评分、音色音量调节等复杂的 K 歌模块，实现了功能组件化，降低了 K 歌功能开发的门槛。SDK 支持：

1> 逐字歌词、逐行歌词、静态歌词

2> 支持演唱评分

3> 支持调节伴奏音量、伴奏升降 Key、麦克风音量、美声音量(仅佩戴耳机时可用)，

4> 支持 EQ 调节

5> 支持耳机返听开关(仅佩戴耳机时可用)

应用场景：

开发环境:

macOS 版本 10.10 及以上版本。

XCode 9.0 或以上版本。(本文 XCode 的界面描述以 XCode 13.0 为例)

iOS 9.0 或以上版本的设备。模拟器暂时不支持本项目，所以请使用真机。

有效的 accessKeyId 授权码。

集成 KXKTVSDK

按照以下步骤将 KXKTVSDK 集成到项目中。

1、 下载KXKTVSDK并解压。

2、 将 SDK 包中 .framework 文件复制到您的项目中。

3、 选择项目的 Targets->Build Phases->Link Binary With Libraries，添加以下依赖库：

AVFoundation.framework

Accelerate.framework

CoreMedia.framework

AudioToolBox.framework

libz.dylib 或者 libz.tbd

libc++.dylib 或者 libc++.tbd

KexuanKTVSDK.framework

添加完成（如下图）：

4、 选择项目的 Targets->Build Phases->Copy Bundle Resources，

将 KexuanKTVSDK.framework 添加到 Bundle Resources 依赖。添加完成（如下图）:

5、选择项目的 Targets->Build Settings 搜索“alway”，将 Always Embed Swift Standard Libraries 的配置更改为 Yes（如下图）

6、选择项目的 Targets->Info，新增 NSMicrophoneUsageDescription 麦克风权限申请提示（如下图）

以上 6 步完成后，KXKTVSDK 就集成在项目中了。接下来我们要在项目中使用 KXKTVSDK 提供的核心 API 实现 K 歌功能，API 调用时序见下图：

API 初始化

开始使用 K 歌 Api 或者回放 Api 时，您需要先对 KXKTVSDK 进行初始化，通过您的授权码 KXKTVSDK 会为您开放相关的 Api 支持。

您可以在您项目的 AppDelegate 文件中，导入 KexuanKTVSDK 的头文件。代码如下:

Swift:      

Objective-C

K 歌 API

K 歌 API 主要由 KXOkAudioPlayer 类完成，使用该 Api 进行 K 歌前，您需要准备好您的伴奏、歌词(可选)、评分档(可选)文件。

该 API 支持逐字歌词、逐行歌词、静态歌词的 K 歌时的同步显示，K 歌过程中可以时时调整伴奏音量、麦克风音量、伴奏升降调、美声及 EQ 音效，佩戴耳机演唱时，还可以开关即时耳返，K 歌完成后会自动保存演唱录音到您指定的文件路径。如果您拥有评分权限，K 歌完成会给您演唱得分。

K 歌服务核心 Api 如下：

附加功能:

您可以运行 KXKTVSDKDemo 示例，体验 K 歌服务。

K 歌参数

K 歌的参数，主要定义 KXKTVSDK 支持的 K 歌采样率、声道、K 歌状态码、异常状态码。

枚举 KXKTVSampleRate:

枚举 KXKTVChannel:

枚举 KXKTVPlayStatus:

枚举 KTVSDKErrorCode:

更多功能说明可访问HIFIVE音加加官网了解