Android工程配置更新时间：2019-05-21 11:25:08

本文是为使用各种SDK做一些通用的准备和说明，包括IDE和工程配置等。

基础准备

  1. 注册微吼开发者账号
  2. 创建应用 获取AppID
  3. 设置应用包名、签名

工程配置

一、开发环境：

  • Android SDK Tools: android-sdk_26.0.|+
  • minSdkVersion: 23
  • targetSdkVersion: 26
  • Android Studio

二、系统要求:

  • SDK 支持 在 Android 6.0（API 23）及以上系统上运行
  • 建议使用 Gradle版本3.x+
  • 需要访问手机硬件,暂不支持模拟器开发

三、接入流程:

1、 新建gradle工程 2、 复制vhallframework.aar(此包是核心包，必须加入，否则任何服务无法使用)

  • vhallframework.aar vhallsdk核心包，用户sdk基础通迅、全局配置、日志管理、权限控制等

3、 复制微吼云服务包到工程libs目录下 例如：如果使用IM服务，只需要添加 vhallims.jar 和 vhallframework.jar便可以使用 IM服务

  • vhalllss.jar 负责直播服务
  • vhallvod.jar 负责录播服务
  • vhallims.jar 负责IM消息服务
  • vhallops.jar 负责文档服务
  • vhallilss.aar 负责互动直播服务 备注：使用Android Studio 会自动加载Jar包，也可以手动添加依赖

四、库简介:

在工程目录下的build.gradle中配置以下文件 1、socket.io 一款公共I/O库，基础通讯功能使用，目前使用截止文档编写之日最新稳定版

compile("io.socket:socket.io-client:0.9.0") {
	exclude group: 'org.json', module: 'json'
}

五 配置权限

在gradle工程找到Android系统文件AndroidManifest，在这里增加项目权限

AndroidManifest

1、注册服务

<service android:name="com.vhall.framework.VhallConnectService"></service>

2、添加权限

<uses-permission android:name="android.permission.CAMERA" />
    <uses-permission android:name="android.permission.RECORD_AUDIO" />
    <uses-permission android:name="android.permission.RECORD_VIDEO" />
    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.WRITE_SETTINGS" />
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    <uses-permission android:name="android.permission.FLASHLIGHT" />
    <uses-permission android:name="android.permission.CHANGE_WIFI_MULTICAST_STATE" />
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
	<uses-permission android:name="android.permission.READ_PHONE_STATE"/>
    <uses-feature android:name="android.hardware.camera" />
    <uses-feature android:name="android.hardware.camera.autofocus" />

六 SDK初始化

SDK初始化，此方法也会获取包名和签名，用于身份验证，如果没有设置请先去开发者中心设置【Android包名和签名】

如果返回【30003 |包检测验证错误】说明包名或者签名填错，请重新核对包名签名。

/**
 * 初始化Sdk，核心方法，在使用微吼云任何服务前调用，
 * @param context 全局唯一，请使用ApplicationContext
 * @param appid 微吼云应用的唯一标识
 * @param userid 用户标识
 * @param InitCallback 初始化SDK的回调
 */
VhallSDK.getInstance().init(getApplicationContext(), appid, userid, new VhallSDK.InitCallback() {
	@Override
	public void onSuccess() {
		// 初始化成功，可以进行后续操作
	}

	@Override
	public void onFailure(String msg) {
		// 初始化失败，请查看appid 等参数是否正确
	}
});

/**
 * 初始化Sdk，核心方法，在使用微吼云任何服务前调用，
 * @param context 全局唯一，请使用ApplicationContext
 * @param appid 微吼云应用的唯一标识
 * @param userid 用户标识
 * @param host    平台域名如api.vhallyun.com
 */
 public void init(Context context, String appid, String userid, String host);

七、添加保持

如果用户使用了混淆功能，可以加入如下的保持信息。

-dontwarn com.vhall.** -keep class com.vhall.** {*;}

//互动SDK 需添加

-dontwarn org.webrtc.** -keep class org.webrtc.** {*;}

八、demo/sdk地址:

https://github.com/vhall/VHYun_SDK_Android