README_iOS

本文主要介绍如何快速地将思为科技 VR带看 SDK(iOS)集成到您的项目中,只要按照如下步骤进行配置,就可以完成 SDK 的集成使用工作。 ## 开发环境要求 - Xcode 9.0+。 - iOS 9.0 以上的 iPhone 或者 iPad 真机。 - 项目已配置有效的开发者签名。 ## 集成 SDK ### 手动集成 1. 下载 SDK,下载完成后进行解压。 2. 打开您的 Xcode 工程项目,选择要运行的 target , 选中 **Build Phases** 项。 ![F0B035F4AEA34131901F9F3CBF0E809F.png](https://cos.easydoc.net/13748344/files/kiqzwihn.png) 3. 单击 **Link Binary with Libraries** 项展开,单击底下的“+”号图标去添加依赖库。 ![D46B0F5FCFC046F995A30C53C9F5C456.png](https://cos.easydoc.net/13748344/files/kiqzwi7k.png) 4. 依次添加所下载的 **IdeaMakeVR.Framework** 及其所需依赖库 **TXLiteAVSDK_TRTC.framework**和 **libc++** 。 ![C2686F3B93B742678FB355463E0FF3CF.png](https://cos.easydoc.net/13748344/files/kiqzwhqk.png) 5. 单击 **Copy Bundle Resources** 项展开,单击底下的“+”号图标去添加资源库。 6. 添加所下载的**IdeaMakeSDK.bunlde**。 ![BCB08C1EB5F346FDB5BA71D1FE5F8F95.png](https://cos.easydoc.net/13748344/files/kiqzwi3y.png) 7. 选中 **Build Settings** 项,在搜索框中搜索**Enable Bitcode**,将值修改为"NO"。 ![247374A1969647E198F25BDC87D17899.png](https://cos.easydoc.net/13748344/files/kiqzwif6.png) 8. SDK中使用了AFNetworking、Masonry和SDWebImage,如果在项目中未使用第三方库,需将demo中的AFNetworking、Masonry、SDWebImage、UIKit+AFNetworking文件夹中的第三方源码加入项目 ![117B3C99927E45608E450092771C297D.png](https://cos.easydoc.net/13748344/files/kiqzwhpw.png) ## 授权摄像头和麦克风使用权限 使用 SDK 的功能,需要授权麦克风和摄像头的使用权限。在 App 的 Info.plist 中添加以下两项,分别对应麦克风和摄像头在系统弹出授权对话框时的提示信息。 - **Privacy - Microphone Usage Description**,并填入麦克风使用目的提示语。 - **Privacy - Camera Usage Description**,并填入摄像头使用目的提示语。 ![7C1D4532A5A447E8BB30043772A440BE.png](https://cos.easydoc.net/13748344/files/kiqzwi0f.png) ## 引用 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 ```