一、开发环境:
备注: 本文以Android Studio 为IDE编译器进行说明,默认观看者拥有Studio的使用基础。
- Android SDK Tools: android-sdk_22.0.|+
- minSdkVersion: 16
- targetSdkVersion: 22
- Android Studio
二、系统要求:
- SDK 支持 在 Android 4.1(API 16)及以上系统上运行,但只有 ( Android 4.3) API 18 以上的系统才能开启硬件编码
三、接入流程:
- 新建gradle工程
- 复制vhallframework1.0.jar到工程lab目录下
- 复制jnilibs文件夹内容到appjni目录下
四、库简介:
vhallframework1.0.jar:vhallsdk基础包,用户sdk基础通迅、全局配置、日志管理、权限控制等。 socket.io 一款公共I/O库,基础通讯功能使用,目前使用截止文档编写之日最新稳定版
compile("io.socket:socket.io-client:0.9.0") {
exclude group: 'org.json', module: 'json'
}
五 配置权限
<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-feature android:name="android.hardware.camera" />
<uses-feature android:name="android.hardware.camera.autofocus" />
六、接口简介:
1 VhallSDK初始化
appid为注册应用时配置的应用ID 初始化操作为SDK的入口,一切SDK功能都在初始化成功后才能使用,建议在应用application启动时调用
VhallSDK.getInstance().init(Context context, String appid);
2 SDK信息配置
1、配置用户ID 用户ID为客户平台用户唯一标识,建议在用户登录之后配置
VhallSDK.getInstance().setUserId(String userid);
2、配置日志显示 设置SDK日志显示(警告和错误级别日志必打印,此开关控制debug/info/verbose级别日志
VhallSDK.getInstance().setLogEnable(boolean enable);
3 获取SDK状态
SDK是否初始化成功并处于可用状态,初始化操作会校验appid对应当前包名和签名,请确保配置正确
VhallSDK.getInstance().isEnable();
4 加入频道
加入频道并接收频道信息,channelid表示当前频道号,如果是lss服务,房间号即为频道号
VhallSDK.getInstance().join(String channelid,Callback callback);
5 离开频道
VhallSDK.getInstance().leave(String channelid);
六、demo地址:
github.com