摘要：重要接口接口含義建議調(diào)用時(shí)機(jī)初始化連接云手機(jī)需要展示云手機(jī)界面時(shí)說(shuō)明使用前請(qǐng)對(duì)工程進(jìn)行配置，否則不生效。該僅支持真機(jī)運(yùn)行。每次進(jìn)入云手機(jī)會(huì)從遠(yuǎn)端獲取分辨率，可以根據(jù)自己的需求修改相應(yīng)的分辨率可以參照設(shè)置分辨率設(shè)置分辨率。

SDK下載

iOS SDK 用于 iOS 終端接入，支持端游和手游。SDK 提供了豐富的接口，滿足大部分接入需求。接入方法請(qǐng)參見(jiàn) 工程配置，并可通過(guò)接口說(shuō)明頁(yè)面，獲取更多功能指引。

工程配置

將我們提供的SDK 壓縮包中 UPhoneSDK.framework 導(dǎo)入項(xiàng)目中（記得選上Copy items if needed）.

Target中所需配置如下：

1、 TARGET -> General -> Frameworks,Libraries,and Embedded Contend -> UPhoneSDK.framework 選擇 Embed & Sign.

2、 TARGET->Build Settings -> Build Options-> Enable Bitcode 選擇 NO.

在工程文件下的 Info.plist文件中加入以下代碼：

<key>NSMicrophoneUsageDescriptionkey>
 <string>此App將要訪問(wèn)您的麥克風(fēng)string>
<key>NSAppTransportSecuritykey>  
<dict>  
<key>NSAllowsArbitraryLoadskey>
<true/>  
dict>CopyErrorSuccess

注：麥克風(fēng)權(quán)限文字可根據(jù)自己App修改。

接入步驟

為方便 iOS 開(kāi)發(fā)者調(diào)試和接入云游戲產(chǎn)品 API，這里向您介紹適用于 iOS 開(kāi)發(fā)的快速接入文檔。快速入門(mén)文檔只提供最主要的接入接口，更多詳細(xì)接口請(qǐng)參考 本文“接口說(shuō)明”部分。

說(shuō)明： SDK 使用前請(qǐng)對(duì)工程進(jìn)行配置，否則 SDK 不生效。

函數(shù)原型

- (instancetype)initWithUphone:(NSString *)uphoneId;CopyErrorSuccess

示例代碼

UTestVideoViewController *videoCallViewController = [[UTestVideoViewController alloc] initWithUphone:phoneId];
videoCallViewController.token = @"123456";CopyErrorSuccess

接口說(shuō)明

函數(shù)原型

- (void)connectUPhone;CopyErrorSuccess

示例代碼

[self connectUPhone];CopyErrorSuccess

注：self是UPhoneVideoViewController的子類

函數(shù)原型

- (void)disConnectUPhone;CopyErrorSuccess

示例代碼

[self disConnectUPhone];CopyErrorSuccess

注：self是UPhoneVideoViewController的子類

函數(shù)原型

+ (void)reconnetUPhone;CopyErrorSuccess

示例代碼

[UPhoneService reconnetUPhone];CopyErrorSuccess

設(shè)置UPhone分辨率

函數(shù)原型

- (void)setUPhoneResolution:(int)resolution;CopyErrorSuccess

示例代碼

[self setUPhoneResolution: resolution];CopyErrorSuccess

注：self是UPhoneVideoViewController的子類

函數(shù)原型

- (NSInteger)getUPhoneLinkDelay;CopyErrorSuccess

示例代碼

- (NSInteger)getUPhoneLinkDelay;CopyErrorSuccess

注：self是UPhoneVideoViewController的子類

函數(shù)原型

+ (NSString *) getVersionCode;CopyErrorSuccess

示例代碼

NSString *delay = [UPhoneService getVersionCode];CopyErrorSuccess

函數(shù)原型

- (void)speedUpUPhone;CopyErrorSuccess

示例代碼

[self speedUpUPhone];CopyErrorSuccess

注：self是UPhoneVideoViewController的子類

函數(shù)原型

- (void)backUPhoneHome;CopyErrorSuccess

示例代碼

[self backUPhoneHome];CopyErrorSuccess

注：self是UPhoneVideoViewController的子類

函數(shù)原型

- (void)backUPhoneLastPage;CopyErrorSuccess

示例代碼

[self backUPhoneLastPage];CopyErrorSuccess

注：self是UPhoneVideoViewController的子類

云手機(jī)獲取當(dāng)前網(wǎng)絡(luò)速度

函數(shù)原型

- (NSString *)getNetworkSpeed;CopyErrorSuccess

返回參數(shù)說(shuō)明： 返回值類型為NSString，單位為 MB/s，保留兩位小數(shù)，例如：0.15MB/s。

示例代碼

NSString *networkSpeed = [self getNetworkSpeed];CopyErrorSuccess

注：self是UPhoneVideoViewController的子類

開(kāi)始直播推流

函數(shù)原型

- (void)startLiving:(NSString *)url;CopyErrorSuccess

示例代碼

[strongSelf startLiving:url];CopyErrorSuccess

注：self是UPhoneVideoViewController的子類

函數(shù)原型

- (void)stopLiving;CopyErrorSuccess

示例代碼

[self stopLiving];CopyErrorSuccess

注：self是UPhoneVideoViewController的子類

云手機(jī)啟動(dòng)后，如果想要獲取當(dāng)前播放器截屏，可以調(diào)用此函數(shù)

函數(shù)原型

- (UIImage *)getShortcut;CopyErrorSuccess

返回參數(shù)說(shuō)明： 返回當(dāng)前播放器截屏的 UIImage 對(duì)象

示例代碼

UIImage *image = [self getShortcut];CopyErrorSuccess

注：self是UPhoneVideoViewController的子類

如果檢測(cè)當(dāng)前截屏的UIImage對(duì)象是否黑屏功能，調(diào)用此函數(shù)

函數(shù)原型

- (NSInteger)checkBlackScreen:(UIImage *)image;CopyErrorSuccess

返回參數(shù)說(shuō)明：

1//檢測(cè)結(jié)果為純色 排除黑色和全透明色，因?yàn)椴シ牌鳑](méi)開(kāi)始工作，不通設(shè)備獲取截屏有的是純黑色有的是純透明色

2//檢測(cè)結(jié)果為純透明色

3//檢測(cè)結(jié)果為正常

4//檢測(cè)結(jié)果為純黑色

示例代碼

NSInteger color = [self checkBlackScreen:image];CopyErrorSuccess

注：self是UPhoneVideoViewController的子類

獲取網(wǎng)絡(luò)傳輸過(guò)程中的丟包率

函數(shù)原型

- (NSString *)getLossRate;CopyErrorSuccess

返回參數(shù)說(shuō)明： 返回值類型為NSString，已轉(zhuǎn)化成百分比并且保留兩位小數(shù)，例如：0.15%。

示例代碼

NSString *lossRate = [self getLossRate];CopyErrorSuccess

注：self是UPhoneVideoViewController的子類

獲取視頻分辨率、橫豎屏參數(shù)

函數(shù)原型

- (NSDictionary *)getQRCodeData;CopyErrorSuccess

返回參數(shù)說(shuō)明:NSDictionary 類型參數(shù)

// key值為style，value返回值為0時(shí)表示橫屏，value為1時(shí)表示豎屏；

// key值為height，value返回值即為當(dāng)前分辨率的height；

// key值為width，value返回值即為當(dāng)前分辨率的width。

示例代碼

NSDictionary *dic =  [strongSelf getQRCodeData];
NSString *style = [dic valueForKey:@"style"];
NSString *height = [dic valueForKey:@"height"];
NSString *width = [dic valueForKey:@"width"];CopyErrorSuccess

注：self是UPhoneVideoViewController的子類

云手機(jī)啟動(dòng)后，通過(guò)該接口獲取用戶最后一次操作實(shí)例的時(shí)間戳 函數(shù)原型

+ (NSString *)getLastUserOperationTimestamp;CopyErrorSuccess

返回參數(shù)說(shuō)明:NSString 類型參數(shù)，單位為：ms。

0//默認(rèn)返回 0，代表用戶沒(méi)有操作過(guò)實(shí)例，否則返回相應(yīng)時(shí)間戳

示例代碼

NSString *lastUserOperationTimestamp = [UPhoneService getLastUserOperationTimestamp];CopyErrorSuccess

云手機(jī)啟動(dòng)后，通過(guò)該接口獲取是否支持直播

函數(shù)原型

- (NSString *)isSupportLiving;CopyErrorSuccess

返回參數(shù)說(shuō)明:NSString 類型參數(shù)

0//未設(shè)置

1//正在啟動(dòng)推流

2//正在推流

3//已停止推流

示例代碼

NSString *isLiveStr = [self isSupportLiving];CopyErrorSuccess

注：self是UPhoneVideoViewController的子類

設(shè)置當(dāng)前的播放是否為靜音狀態(tài)

函數(shù)原型

- (void)setAudioMute:(BOOL)isMute;CopyErrorSuccess

傳入?yún)?shù)說(shuō)明:BOOL類型參數(shù)

YES：全局靜音

NO：取消全局靜音

示例代碼

BOOL mute1 = [self setAudioMute:YES];
BOOL mute2 = [self setAudioMute:NO];CopyErrorSuccess

注：self是UPhoneVideoViewController的子類

注意事項(xiàng)

1.該SDK僅支持iOS10以上系統(tǒng)。

2.該SDK僅支持真機(jī)運(yùn)行。

3.需要用到SDK的地方增加頭文件#import

4.跳轉(zhuǎn)到新建子類的界面時(shí)，前者需要遵守< UPhoneVideoViewControllerDelegate>協(xié)議，在退出云手機(jī)時(shí)需要的一些方法可以寫(xiě)在協(xié)議方法里面。

5.每次進(jìn)入云手機(jī)會(huì)從遠(yuǎn)端獲取分辨率，可以根據(jù)自己的需求修改相應(yīng)的分辨率可以參照設(shè)置分辨率。