# 准备开发环境

本章将介绍如何将 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:

# 方法一:使用 JCenter 自动集成

TIP

该方法仅适用于 2.1 及以上版本的 JC SDK 集成。

在项目的 /app/build.gradle 文件中,添加如下行:

...
dependencies {
    ...
    // 可通过 JC SDK 发版说明取得最新版本号
    implementation 'com.JuphoonCloud:JC-SDK:<最新版本号>'
}

# 方法二:手动导入 JC SDK

  1. 下载 JC SDK 并解压。

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

  3. 为确保能够连接到 so 库,需要在 modulebuild.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$* {*;}