HIFIVE 音加加提供曲库、评分、修音功能的 K 歌 SDK-Android 版本
功能说明:
KXKTVSDK 整合了歌词展示、演唱评分、音色音量调节等复杂的 K 歌模块,实现了功能组件化,降低了 K 歌功能开发的门槛。SDK 支持:
√ 逐字歌词、逐行歌词、静态歌词
√ 支持演唱评分
√ 支持调节伴奏音量、伴奏升降 Key、麦克风音量、美声音量(仅佩戴耳机时可用),
√ 支持 EQ 调节
√ 支持耳机返听开关(仅佩戴耳机时可用)√ 支持导唱(仅在有导唱文件时可用)
KXKTVSDK 还支持录音回放,调整新的音效比例后导出新的作品文件。
应用场景:
开发环境
本文的界面描述以 AndroidStudio 4.1 为例 Android 6.0 或以上版本的设备,。模拟器暂时不支持本项目,所以请使用真机。有效的 accessKeyFile 授权文件。(如何拥有授权文件?)
注意:SDK 目前只提供"armeabi-v7a", "arm64-v8a"两种 abi 模式。
集成 KXKTVSDK
按照以下步骤将 KXKTVSDK 集成到项目中。1、下载 KXKTVSDK 并解压。2、将 SDK 包中 .aar 文件复制到您项目的 libs 文件夹中。
3、选择项目的 gradle 配置文件,配置扩展库版本号:buildscript {
}
4、选择 module 的 gradle 配置文件,添加依赖资源配置:implementation fileTree(include: ['.jar', '.aar'], dir: 'libs')
implementation "org.apache.directory.studio:org.apache.commons.io:2.4"implementation "androidx.compose.ui:ui:$compose_version"implementation "androidx.compose.material:material:$compose_version"implementation "androidx.compose.ui:ui-tooling-preview:$compose_version"
5、AndroidManifest.xml 中添加 sdk 需要的权限:<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/><uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/><uses-permission android:name="android.permission.RECORD_AUDIO"/><uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
以上 5 步完成后,KXKTVSDK 就集成在项目中了。接下来我们要在项目中使用 KXKTVSDK 提供的核心 API 实现 K 歌功能,录音回放编辑功能,API 调用时序见下图:
API 初始化
开始使用 K 歌 Api 或者回放 Api 时,您需要先对 KXKTVSDK 进行初始化,通过您的 APPID,KXKTVSDK 会为您开放相关的 Api 支持。
您可以在您项目的 Application 文件中,导入 import com.hero.kxktvsdk.KXKTVSDKManager 代码如下:
K 歌 API
K 歌 API 主要由 KXOkAudioPlayer 类完成,使用该 Api 进行 K 歌前,您需要准备好您的伴奏、歌词(可选)、评分档(可选)文件。
该 API 支持逐字歌词、逐行歌词、静态歌词的 K 歌时的同步显示,K 歌过程中可以时时调整伴奏音量、麦克风音量、伴奏升降调、美声及 EQ 音效,佩戴耳机演唱时,还可以开关即时耳返,K 歌完成后会自动保存演唱录音到您指定的文件路径。如果您拥有评分权限,K 歌完成会给您演唱得分。
K 歌服务核心 Api 如下:
附加功能:
您可以运行 KXKTVSDKDemo 示例,体验 K 歌服务。
回放编辑 API
回放编辑 API 主要由 KXOkEditPlayer 类完成,使用该 Api 进行回放编辑前,您需要结束 K 歌 API(KXOkAudioPlayer)的使用,准备好您的伴奏、已存在的录音文件、歌词(可选)、评分档(可选)文件。
该 API 支持逐字歌词、逐行歌词、静态歌词的回放时的同步显示,回放过程中可以时时调整录音作品的伴奏音量倍数、麦克风音量倍数、美声及 EQ 音效,编辑完成后,您可以通过导出 Api 导出一份新的录音文件到您指定的文件路径。
回放编辑服务核心 Api 如下:
附加功能:
您可以运行 KXKTVSDKDemo 示例,体验回放编辑服务。
K 歌参数
K 歌的参数,主要定义 KXKTVSDK 支持的 K 歌采样率、声道、K 歌状态码、异常状态码。
枚举 KXKTVSampleRate:
枚举 KXKTVChannel:
枚举 KXKTVPlayStatus:
枚举 KTVSDKErrorCode:
更多功能说明可访问 HIFIVE音加加 官网了解
评论