README_Android
本文主要介绍如何快速地将 VR带看 SDK(Android) 集成到您的项目中，只要按照如下步骤进行配置，就可以完成 SDK 的集成工作。
## 开发环境要求
- Android Studio 3.5+。
- Android 4.4（SDK API 19）及以上系统。
## 集成 SDK
### 手动集成
您可以手动下载 SDK 集成到工程里：
1. 下载最新版本 SDK。
2. 将下载到的 aar 文件拷贝到工程的 **app/libs** 目录下。
3. 在工程根目录下的 build.gradle 中，添加 **flatDir**，指定本地仓库路径。
4. 在 app/build.gradle 中，添加引用 aar 包的代码。
5.在 app/build.gradle的defaultConfig 中，指定 App 使用的 CPU 架构。
```
defaultConfig {
ndk {
abiFilters "armeabi", "armeabi-v7a", "arm64-v8a"
}
}
```
> 目前 SDK 支持 armeabi ， armeabi-v7a 和 arm64-v8a。
6. 添加SDK使用的第三方库
```
dependencies {
implementation 'com.google.code.gson:gson:2.8.6'
implementation("com.squareup.okhttp3:okhttp:4.8.1")
implementation 'com.squareup.picasso:picasso:2.71828'
implementation 'de.hdodenhof:circleimageview:3.1.0'
implementation 'com.alibaba:fastjson:1.1.46.android'
}
```
7. 单击【Sync Now】，完成 SDK 的集成工作。
## 配置 App 权限
在 AndroidManifest.xml 中配置 App 的权限，TRTC SDK 需要以下权限：
```
<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.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-feature android:name="android.hardware.camera" />
<uses-feature android:name="android.hardware.camera.autofocus" />
```
## 设置混淆规则
在 proguard-rules.pro 文件，将 TRTC SDK 相关类加入不混淆名单：
```
-keep class com.tencent.** { *; }
```
## 设置 App 打包参数
在 app/build.gradle 下，添加如下信息：
```
packagingOptions {
pickFirst '**/libc++_shared.so'
doNotStrip "*/armeabi/libYTCommon.so"
doNotStrip "*/armeabi-v7a/libYTCommon.so"
doNotStrip "*/x86/libYTCommon.so"
doNotStrip "*/arm64-v8a/libYTCommon.so"
}
```
## 引用 SDK
项目代码中使用 SDK
- 在项目需要使用 SDK API 的文件里，引入文件。
```
import com.ideamake.vrsdk.IMSDKManager;
```
### SDK初始化接口
- 在项目需要使用 SDK 的地方，添加参数初始化SDK。
```
/* SDK初始化接口。
* USERID 当前用户ID
*/
IMSDKManager.initSDK(USERID);
// 测试环境
// IMSDKManager.initSDK(GeneraTestInfo.USERID,"test-api.ideamake.cn");
```
### SDK使用接口
- 在收到推送时调用的页面打开接口
```
/* VR带看界面打开。
* context 上下文
* INFOString 推送收到的信息
*/
IMSDKManager.enterVRView(context,PUSHSTRING,new ExitCallBack() {
@Override
public void exitVRView(String userId) {
//退出VR带看页面的回调，回调信息为用户ID
}, new ShareCallBack() {
@Override
public void shareToWeixin() {
// 收到用户点击分享按钮
}
});
```