README_iOS
本文主要介绍如何快速地将思为科技 VR带看 SDK(iOS)集成到您的项目中,只要按照如下步骤进行配置,就可以完成 SDK 的集成使用工作。
## 开发环境要求
- Xcode 9.0+。
- iOS 9.0 以上的 iPhone 或者 iPad 真机。
- 项目已配置有效的开发者签名。
## 集成 SDK
### 手动集成
1. 下载 SDK,下载完成后进行解压。
2. 打开您的 Xcode 工程项目,选择要运行的 target , 选中 **Build Phases** 项。

3. 单击 **Link Binary with Libraries** 项展开,单击底下的“+”号图标去添加依赖库。

4. 依次添加所下载的 **IdeaMakeVR.Framework** 及其所需依赖库 **TXLiteAVSDK_TRTC.framework**和 **libc++** 。

5. 单击 **Copy Bundle Resources** 项展开,单击底下的“+”号图标去添加资源库。
6. 添加所下载的**IdeaMakeSDK.bunlde**。

7. 选中 **Build Settings** 项,在搜索框中搜索**Enable Bitcode**,将值修改为"NO"。

8. SDK中使用了AFNetworking、Masonry和SDWebImage,如果在项目中未使用第三方库,需将demo中的AFNetworking、Masonry、SDWebImage、UIKit+AFNetworking文件夹中的第三方源码加入项目

## 授权摄像头和麦克风使用权限
使用 SDK 的功能,需要授权麦克风和摄像头的使用权限。在 App 的 Info.plist 中添加以下两项,分别对应麦克风和摄像头在系统弹出授权对话框时的提示信息。
- **Privacy - Microphone Usage Description**,并填入麦克风使用目的提示语。
- **Privacy - Camera Usage Description**,并填入摄像头使用目的提示语。

## 引用 SDK
项目代码中使用 SDK
- 在项目需要使用 SDK API 的文件里,引入具体的头文件。
```
#import <IdeaMakeVR/IMSDKManager.h>
```
### SDK初始化接口
- 在项目需要使用 SDK 的地方,添加参数初始化SDK。
```
/* SDK初始化接口。
* USERID 当前用户ID
*/
[IMSDKManager initSDKWithUserId:USERID];
// 测试环境
// [IMSDKManager initSDKWithUserId:USERID serverAddress:@"test-api.ideamake.cn"];
```
### SDK使用接口
- 在收到推送时调用的页面打开接口
```
/* VR带看界面打开。
* PushString 推送收到的信息
* vc 当前视图控制器
*/
[IMSDKManager enterVRView:PushString viewController:vc];
```
### SDK代理方法实现
- 在项目需要使用 SDK Delegate的地方,遵守IMSDKDelegate
```
@interface ViewController () <IMSDKDelegate>
@end
@implementation ViewController
- (void)viewDidLoad {
[super viewDidLoad];
// 设置Delegate
[IMSDKManager setDelegate:self];
}
#pragma mark - IMSDKDelegate
- (void)exitVRView:(NSString *)userId
{
// 回调为退出用户的ID
NSLog(@"exitVRView UserId=%@",userId);
}
- (void)wantToShare{
NSLog(@"分享回调");
}
@end
```