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

SDK下載

iOS SDK 用于 iOS 終端接入，支持端游和手游。SDK 提供了豐富的接口，滿足大部分接入需求。接入方法請參見 工程配置，并可通過接口說明頁面，獲取更多功能指引。

工程配置

將我們提供的SDK 壓縮包中 UPhoneSDK.framework 導入項目中（記得選上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將要訪問您的麥克風string>
<key>NSAppTransportSecuritykey>  
<dict>  
<key>NSAllowsArbitraryLoadskey>
<true/>  
dict>CopyErrorSuccess

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

接入步驟

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

說明： SDK 使用前請對工程進行配置，否則 SDK 不生效。

函數(shù)原型

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

示例代碼

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

接口說明

函數(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的子類

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

函數(shù)原型

- (NSString *)getNetworkSpeed;CopyErrorSuccess

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

示例代碼

NSString *networkSpeed = [self getNetworkSpeed];CopyErrorSuccess

注：self是UPhoneVideoViewController的子類

開始直播推流

函數(shù)原型

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

示例代碼

[strongSelf startLiving:url];CopyErrorSuccess

注：self是UPhoneVideoViewController的子類

函數(shù)原型

- (void)stopLiving;CopyErrorSuccess

示例代碼

[self stopLiving];CopyErrorSuccess

注：self是UPhoneVideoViewController的子類

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

函數(shù)原型

- (UIImage *)getShortcut;CopyErrorSuccess

返回參數(shù)說明： 返回當前播放器截屏的 UIImage 對象

示例代碼

UIImage *image = [self getShortcut];CopyErrorSuccess

注：self是UPhoneVideoViewController的子類

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

函數(shù)原型

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

返回參數(shù)說明：

1//檢測結(jié)果為純色 排除黑色和全透明色，因為播放器沒開始工作，不通設(shè)備獲取截屏有的是純黑色有的是純透明色

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

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

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

示例代碼

NSInteger color = [self checkBlackScreen:image];CopyErrorSuccess

注：self是UPhoneVideoViewController的子類

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

函數(shù)原型

- (NSString *)getLossRate;CopyErrorSuccess

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

示例代碼

NSString *lossRate = [self getLossRate];CopyErrorSuccess

注：self是UPhoneVideoViewController的子類

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

函數(shù)原型

- (NSDictionary *)getQRCodeData;CopyErrorSuccess

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

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

// key值為height，value返回值即為當前分辨率的height；

// key值為width，value返回值即為當前分辨率的width。

示例代碼

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

注：self是UPhoneVideoViewController的子類

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

+ (NSString *)getLastUserOperationTimestamp;CopyErrorSuccess

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

0//默認返回 0，代表用戶沒有操作過實例，否則返回相應(yīng)時間戳

示例代碼

NSString *lastUserOperationTimestamp = [UPhoneService getLastUserOperationTimestamp];CopyErrorSuccess

云手機啟動后，通過該接口獲取是否支持直播

函數(shù)原型

- (NSString *)isSupportLiving;CopyErrorSuccess

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

0//未設(shè)置

1//正在啟動推流

2//正在推流

3//已停止推流

示例代碼

NSString *isLiveStr = [self isSupportLiving];CopyErrorSuccess

注：self是UPhoneVideoViewController的子類

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

函數(shù)原型

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

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

YES：全局靜音

NO：取消全局靜音

示例代碼

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

注：self是UPhoneVideoViewController的子類

注意事項

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

2.該SDK僅支持真機運行。

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

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

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