本文介绍如何集成曲库 SDK。

前提条件

请确认您已完成以下操作：

• 已创建应用并获取 App Key
• 已开通曲库能力

开发环境要求

开发环境要求如下：

环境要求	说明
JDK 版本	1.8.0 及以上版本
Android API 版本	API 21、Android Studio 5.0 及以上版本
CPU架构	ARM 64、ARMV7
IDE	Android Studio
其他	依赖 Androidx，不支持 support 库。

SDK目录

Android
|
|-- lib                      //推荐放置在 /app/libs/ 目录
|   |
|   |-- NECopyrightedmedia-x.x.x.aar    //版权SDK

步骤1 下载并导入曲库 SDK

方式1 通过 Maven 集成（推荐）

1. 若您需要创建新项目，在 Android Studio 里，在顶部菜单依次选择 File > New > New Project 新建工程，再依次选择 Phone and Tablet > Empty Activity，单击 Next。
   

   创建 Android 项目成功后，Android Studio 会自动开始同步 gradle, 您需要等同步成功后再进行下一步操作。

2. 在 /Gradle Scripts/build.gradle(Project: <projectname>) 文件中添加以下代码，添加曲库 SDK 的依赖。

   repositories {
       mavenCentral()
   }
   
   implementation "com.netease.yunxin.kit.copyrightedmedia:copyrightedmedia:+"
   

方式2 手动集成

1. 下载曲库 SDK并解压到本地。
2. 拷贝文件到您的工程中。

   若无对应文件夹，您需要在对应路径下新建文件夹。
   无特殊情况，可忽略 part 文件夹。

   文件/文件夹	项目路径
   NECopyrightedmedia-x.x.x.aar	/app/libs/

3. 在 app/build.gradle 文件中设置 libs 路径。

   android {
       ...
       compileOptions {
           // SDK 依赖的JDK版本为Java 8
           sourceCompatibility JavaVersion.VERSION_1_8
           targetCompatibility JavaVersion.VERSION_1_8
       }
       ...
       
       dependencies {
           implementation fileTree(dir: "libs", include: ["*.aar"])
           ...
       }
   }
   

4. 单击 File > Sync Project With Gradle Files 按钮，直到同步完成。

步骤2 配置权限

在 app/src/main/AndroidManifest.xml 文件中添加类似如下代码，添加相应的设备权限。

<!-- 访问网络 -->
<uses-permission android:name="android.permission.INTERNET" />
<!-- 外置存储存取权限 -->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

步骤3 配置防代码混淆

在 proguard-rules.pro 文件中，将 NEKaraokeKit SDK 相关的类加入到不混淆名单。

-dontwarn com.netease.yunxin.kit.copyrightedmedia.**
-keep class com.netease.yunxin.kit.copyrightedmedia.** {*;}