Cloud Phone：iOS SDK

Integration Environment要求

SDK整合

SDK許可權

Privacy - Microphone Usage Description

Privacy - Camera Usage Description

SDK簽名

security find-identity -v -p codesigning

set -e
SHELL_PATH="${PROJECT_DIR}/ASPDemo/Lib/ASPEngineSDK/ASPEngineSDK.framework/link_and_sign.sh"
KEY_ID="你認證的簽名ID"
echo "===> Signing using $KEY_ID"
/bin/bash -c "${SHELL_PATH}"\ "${TARGET_BUILD_DIR}"\ "${FRAMEWORKS_FOLDER_PATH}"\ "${KEY_ID}"

工程配置注意事項

方案詳見無影雲手機快速整合最佳實務。 雲手機整合的總體方案如下圖所示

有多種登入方式，擷取整合SDK所需要的串連雲手機Ticket憑證，流程圖為：

具體整合代碼可以參考生命週期介面的參考代碼。

2.1 初始化執行個體

+ (instancetype)buildStreamView;

2.2 建立串連

- (void)startWithTicket:(ASPConnTicket*) ticketParam;

ASPConnTicket參數說明：

2.3 中斷連線

- (int)stop;

2.4 暫停

暫停雲端下發流和端側流渲染

- (void)pause;

2.5 恢複

恢複雲端下發流和端側流渲染

- (void)resume;

2.6 銷毀執行個體

- (void)dispose;

2.7 回調說明

//雲手機串連相關回調
@property (nonatomic, weak) id<ASPEngineDelegate> engineDelegate;
//解析度發生變化回調
@property (nonatomic, weak) id<ASPEngineResolutionUpdateDelegate> resolutionUpdateDelegate;
//滑鼠游標相關回調
@property (nonatomic, weak) id<ASPEngineCursorDelegate> cursorDelegate;
//雲手機方向發生變化回調
@property (nonatomic, weak) id<ASPEngineOrientationUpdateDelegate> orientationUpdateDelegate;
//埋點相關回調
@property (nonatomic, weak) id<ASPEngineStatisticsDelegate> statisticsDelegate;
//IME相關回調 雲手機暫不支援
@property (nonatomic, weak) id<ASPEngineIMEDelegate> imeDelegate;
//LOG相關回調，delegate建議使用單例
+ (void)setASPEngineLogDelegate:(id<ASPEngineLogDelegate>)delegate;
+ (void)unsetASPEngineLogDelegate;

雲手機串連相關回調ASPEngineDelegate

LyncChannel使用樣本：

//預設命令通道LyncChannel name為static NSString *LYNC_CHANNEL_NAME = @"lync_adb_shell";
//添加LyncChannelself.lync = [[DemoLyncChannel alloc] initWithParameter:LYNC_CHANNEL_NAME];
[self.streamView addLyncChannel:self.lync];
//移除LyncChannel
[self.streamView removeLyncChannel:self.lync];
//LyncChannel實現@interface DemoLyncChannel : BaseLyncChannel@property (nonatomic, strong) NSString *lslaID;

@end@implementation DemoLyncChannel

- (void)onConnectStateChanged:(BOOL)connected {
    NSLog(@"[DemoLyncChannel] onConnectStateChanged %d", connected);
    if (connected) {
        //TEST send cmdself.lslaID = [DemoToolBox getID];
        NSString *cmdData = [DemoToolBox getJsonDataWithId:self.lslaID cmd:@"ls -la"];
        NSLog(@"[DemoLyncChannel] cmdData : %@", cmdData);
        LyncErrorCode code = [self sendString:cmdData];
        NSLog(@"[DemoLyncChannel] cmdData code: %ld", code);
    }
}
- (void)onReceiveStringData:(NSString * _Nonnull)buf {
    NSLog(@"[DemoLyncChannel] onReceiveStringData %@", buf);
    NSDictionary *dic = [DemoToolBox convertStringToJSON:buf];
    NSString *ID = [dic objectForKey:@"id"];
    if (ID != NULL && ID.length && [self.lslaID isEqualToString:ID]) {
        NSLog(@"[DemoLyncChannel] onReceiveStringData get ls -la result");
    }
}
- (void)onReceiveRawData:(NSData * _Nonnull)buf {
    NSString *string = [[NSString alloc] initWithData:buf encoding:NSUTF8StringEncoding];
    NSLog(@"[DemoLyncChannel] onReceiveRawData %@", string);
}
@end

DataChannel使用樣本：

//預設DataChannel name為static NSString *DATA_CHANNEL_NAME = @"wy_vdagent_default_dc";
//添加DataChannelself.esdAgent = [[DemoEDSAgentChannel alloc] initWithParameter:DATA_CHANNEL_NAME];
[self.streamView addDataChannel:self.esdAgent];
//移除DataChannel
[self.streamView removeDataChannel:self.esdAgent];
//DataChannel實現@interface DemoEDSAgentChannel : BaseEDSAgentChannel@end@implementation DemoEDSAgentChannel

- (void)onConnectStateChanged:(ASPDCConnectState)state {
    NSLog(@"[DemoEDSAgentChannel] onConnectStateChanged %ld", state);
    if (state == OPEN) {
        // to send data
    }
}
- (void)onReceiveData:(NSData * _Nonnull)buf {
    NSString *string = [[NSString alloc] initWithData:buf encoding:NSUTF8StringEncoding];
    NSLog(@"[DemoEDSAgentChannel] onConnectStateChanged %@", string);
}
@end

訊息通道使用datachannel，datachannel名稱為wy_vdagent_default_dc。

訊息大小限制500KB。

基體訊息格式如下：

DataChannel 端側發送訊息給鏡像 client --> guest

action:insertcontact/insertsms/sendcontactcvf

• insertcontact是插入連絡人

參數name是連絡人名稱，必填。

參數phonenumber是電話號碼，必填。

• insertsms是插入簡訊

參數phonenumber是電話號碼, 必填。

參數textbody是簡訊內容，必填。

參數canInsertdb是否可以插入雲手機簡訊資料庫，選填，預設0, 不插入， 1為插入。

樣本：let jsonarray = [{'action': 'insertcontact','importdata':[{ 'name': '**', 'phonenumber': '**' }, { 'name': '**', 'phonenumber': '**' }]},{'action': 'insertsms','importdata':[{'phonenumber':'**','textbody':'**,"canInsertdb":0/1}]}]

• sendcontactvcf是通過vcf插入連絡人

參數data是vcf檔案資料流，必填，若檔案過大，需拆包，一個包最大1MB。

參數allsize是vcf檔案資料總大小，必填。

樣本：{'action': 'sendcontactvcf',importdata:{data:"", "allsize":檔案資料總大小, "timestamp":時間戳記}}。

public void processByteArrayInChunks(byte[] data) {
    int chunkSize = 512 * 1024; // 500KB in bytesint length = data.length;
    long timestamp = System.currentTimeMillis();
    for (int i = 0; i < length; i += chunkSize) {
        int end = Math.min(i + chunkSize, length);
        byte[] chunk = Arrays.copyOfRange(data, i, end);
        String str = new String(chunk, StandardCharsets.UTF_8);
        /**
          {'action': 'sendcontactvcf','importdata':{"data":str, "allsize":length, "timestamp":timestamp}}
        */
    }
}

String recvData = "";
int recvSize = 0;
long recvTimestamp = 0;
public void onMessageReceive(byte[] message) {
  String action = getActioin(meesage);
  String data = getData(message);
  int length = data.length;
  int allSize = getAllSize(message);
  long timestamp = getTimestamp(message);
  if (timestamp != recvTimestamp) {
    clearRecv();
  }
  if (action.equals("sendcontactvcf")) {
    recvSize += length;
    recvData = recvData + data;
    if (recvSize >= allSize) {
      // recvData 寫vcf檔案 插入連絡人
      insertContact(vcfFilePath);
      sendack()
      clearRecv();
    }
  }
}

public void clearRecv() {
  recvData = ""
  recvSize = 0;
  recvTimestamp = 0;
}

DataChannel 鏡像發送訊息給端側 guest --> client

action:openeditsms/openphone/rotation

• openeditsms開啟編輯簡訊頁面

參數importdata.phonenumber是電話號碼，選填。

參數textbody是簡訊內容，選填。

樣本：{'action': 'openeditsms',importdata:{"phonenumber":"***", "textbody":"***"}} 

• openphone開啟電話撥號頁面

參數importdata.phonenumber是電話號碼，選填，有電話號，則開啟撥打指定連絡人頁面，沒有電話號碼，則開啟電話撥號頁面。

樣本：{'action': 'openphone','importdata':{"phonenumber":"***"}} 或 {'action': 'openphone'}

DataChannel 回執訊息

action:ack

• ack是指不管是端側發送訊息給鏡像，還是鏡像發送訊息給端側，收到訊息側，根據業務需要，可回執ack訊息，表明訊息處理的情況

參數source是接收到訊息的action，必填。

參數code是狀態代碼，必填值為0表示未知，1 執行source，2 執行成功，3 執行失敗， 4 不支援執行。

樣本：{'action': 'ack','importdata':{"source":"***", "code": *,"id":*}}

4.1 ASPConnTicket

建立串連的配置參數。

4.2 ASPStatisticsInfo

效能資料

5.1 ASPScaleType

流化映像內容縮放處理類型。