准备开发环境

本章将介绍如何将 JC SDK 集成到您自己创建的项目中。

前提条件

• Android SDK API 等级 16 或以上

• Android Studio 3.5及以上版本

• 支持 Android 4.1 或以上版本的移动设备

• 有效的菊风开发者账号（免费注册 (opens new window) ）

• 有效的菊风 AppKey

创建 Android 项目

参考以下步骤创建一个 Android 项目。若已有 Android 项目，可以直接查看【集成 SDK】。

• 打开 Android Studio，点击 Start a new Android Studio project。

• 在 Select a Project Template 界面，选择 Phone and Tablet -> Empty Activity，然后点击 Next。

• 在 Configure Your Project 界面，依次填入以下内容：

  • Name：您的 Android 项目名称，如 HelloJuphoon。

  • Package name：您的项目包的名称，如 io.helloJuphoon。

  • Save location：项目的存储路径

  • Language：项目的编程语言，如 Java

  • Minimum API level：项目的最低 API 等级

• 然后点击 Finish。根据屏幕提示，安装可能需要的插件。

集成 SDK

您可以通过以下两种方式中任意一种集成 JC SDK：

方法一：使用 Maven 自动集成

1. 在工程的 /build.gradle 文件中，添加如下内容：

   allprojects {
       repositories {
           ...
           maven { url 'https://repo1.maven.org/maven2/' }
           //或者 mavenCentral()
       }
   }
   

2. 在 app 模块的 build.gradle 文件中添加依赖。通过 SDK 发版说明 (opens new window) 获取最新版本号，并将示例代码中 x.y.z 改为最新版本号：

   // x.y.z 请填写具体版本号，如：2.13.2
   // 可以通过 SDK 发版说明获取最新版本号
   dependencies {
       implementation 'io.github.juphoon-app:jcsdk:x.y.z'
   }
   

方法二：手动导入 JC SDK

1. 下载 JC SDK (opens new window) 并解压。

2. 拷贝 libs 文件夹内的 arm64-v8a、armeabi-v7a、x86、x86_64、JCSDK.jar、mtc.jar 和 zmf.jar 到您工程目录中的 libs 目录下。

3. 为确保能够连接到 so 库，需要在 module 的 build.gradle 中添加设置:

   sourceSets {
       main {
           jniLibs.srcDirs = ['libs']
       }
   }
   

添加项目权限

根据场景需要，在 /app/src/main/AndroidManifest.xml 文件中添加如下行，获取相应的设备权限：

<uses-feature android:name="android.hardware.camera" />
<uses-feature android:name="android.hardware.camera.autofocus" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.WAKE_LOCK" />
<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.VIBRATE"/>
<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" />

TIP

您在 AndroidManifest 中进行权限配置时，请确保您能够获得打开摄像头、音视频录制等相关权限。

设置混淆规则

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

-dontwarn com.juphoon.*
-keep class com.juphoon.**{*;}
//底层sdk
-dontwarn com.justalk.*
-keep class com.justalk.**{*;}
-keepattributes InnerClasses
-keep class **.R$* {*;}