一、开发环境:

备注: 本文以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