4.1. 简介和下载

4.1.1. 基本介绍

当前 实时猫 Android SDK 最新版本为 0.6

实时猫 Android SDK 提供以下基本功能:

  • 仅支持 Android 4.1+(API 16)
  • 音视频频通信
  • 通过服务器的数据传输 (暂不支持文件传输)
  • 点对点文件,数据传输
  • 降噪处理
  • 可自定义音频输出设备 ,并支持实时切换
  • 可自定义摄像头设备,并支持实时切换 (部分x86设备可能出现不识别 USB 摄像头的情况)
  • 可自定义视频硬解码 (目前支持 VP8, VP9, H.264,Android 默认使用 VP8 编码)
  • 摄像头自动对焦
  • 视频和音频调试功能
  • Android手机屏幕分享功能(支持 Android 5.0+ (API 21)

实时猫 Android SDK v0.4 可以和 实时猫Javascript SDK v0.3 版本相互通信。

实时猫 Android SDK v0.5、v0.6 版本 可以和 实时猫Javascript SDK v0.4 版本、 实时猫iOS SDK v0.2 相互通信。

4.1.2. 下载/引入

下载JAR文件v0.6

下载SO文件v0.6

推荐Android开发者使用/升级到v0.6 SDK

下载JAR文件v0.5

下载SO文件v0.5

4.1.3. 用法

1.在 AndroidManifest.xml 中增加以下权限

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
    <uses-feature android:name="android.hardware.camera" />
    <uses-feature android:name="android.hardware.camera.autofocus" />
    <uses-feature android:glEsVersion="0x00020000" android:required="true" />

    <uses-permission android:name="android.permission.CAMERA" />
    <uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
    <uses-permission android:name="android.permission.RECORD_AUDIO" />
    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
    <uses-permission android:name="android.permission.CHANGE_NETWORK_STATE"/>

注意 : 如果需要 文件传输功能蓝牙功能 需要自行增加权限。

Android 6 由于权限机制不同,需要开发者自行获得相机和麦克风权限,如需存储文件,请自行获得文件存储权限。

1
2
3
4
5
    String[] permssions = {
            Manifest.permission.RECORD_AUDIO,
            Manifest.permission.CAMERA
    };
    ActivityCompat.requestPermissions(this,permssions, 111);

2.导入 jarso 文件

Android Studio 为例

../_images/example.png

jarso 文件移到如上图位置后,右键点击 jar 文件,选择 Add As Library

3.通过 实时猫开发者后台或者 实时猫服务器 RESTful API 获得 SessionToken 进行通信。具体实现请参考下面章节的样例程序。

4.1.4. 前提知识