快速开始

将cloudphone-merge-cloudapp-xxx-kp.hmtp-cabin-xxx.aar放到工程libs下引入。

1. 在AppAplication中初始化串流SDK。

   CloudPhoneClient.init(Application application, Callback callback, boolean openLog);
   CloudPhoneClient.playerForceTextureView(false);
   CloudPhoneClient.setLogFolder(this.getExternalFilesDir("log").getPath() + File.separator);

   初始化说明：

   • callback：非必填，云机串流的结果及中途异常消息回调，初始化可空。
   • openLog：是否输出log，是否加密本地日志文件。

   传入日志文件位置：由于安全合规且自定义，需要传入app私有路径，方便排查。

2. 获取IAM token，可参考文档获取IAM用户Token。

   接口地址：POST https://iam.myhuaweicloud.com/v3/auth/tokens?nocatalog=true。

   请求示例：

   {
       "auth": {
           "identity": {
               "methods": [
                   "password"
               ],
               "password": {
                   "user": {
                       "domain": {
                           "name": "IAMDomain"        //IAM用户所属账号名
                       },
                       "name": "IAMUser",             //IAM用户名
                       "password": "IAMPassword"      //IAM用户密码
                   }
               }
           },
           "scope": {
               "project": {
                   "name": "cn-north-1"               //项目名称
               }
           }
       }
   }

   获取token:

   响应Header参数（获取到的Token）：
   X-Subject-Token:MIIatAYJKoZIhvcNAQcCoIIapTCCGqECAQExDTALB...

1. 获取云机设备token与地址信息，可参考文档租户实例串流前获取设备的device_token。

   接口地址：POST https://koophone.myhuaweicloud.com/v1/instances/{instance_id}/auth。

   请求示例

   post接口，请求url中携带租户自己购买的实例和租户的token直接调用。

   /v1/instances/xxxxxx/auth

   响应示例

   状态码：200

   实例鉴权接口返回设备信息。

   {
     "data" : {
       "resource" : {
         "sdk" : {
           "internal" : {
             "address" : null,
             "aport" : null,
             "atype" : null,
             "address_ipv6" : null
           },
           "external" : {
             "address" : "10.83.71.187",
             "aport" : 10030,
             "atype" : 1,
             "address_ipv6" : null
           }
         },
         "rtc" : {
           "ice_signaling" : {
             "signaling_url" : "http://100.93.2.248:18082",
             "expired_time" : null,
             "ice_servers" : [ ]
           }
         },
         "device_id" : "7b0cd026df8d495b8a65d628d7bec433",
         "kp_id" : "Q39YyZvI"
       },
       "device_token" : "dee5081f40c83ddea3ded91c387351e9"
     },
     "error_code" : "0",
     "error_msg" : "ok"
   }

2. 启动串流。
   关于CloudPhoneClient其他公开方法说明可参考表1。

   表1 CloudPhoneClient方法名及参数说明

   方法名及参数	说明
   start(PlayerFragment mPlayerFragment, Bundle extras)	开始串流
   closeApp(String packageName)	通过应用包名强制关闭云手机中运行的目标应用
   startApp(String packageName)	通过包名/类名或Scheme协议启动目标应用，支持传递自定义参数
   uninstallApp(String packageName)	通过应用包名卸载云手机中的指定应用（系统级静默卸载，无需用户确认）
   getRunningApps(GetAppsReq req)	查询当前云手机环境中正在运行的应用列表及其状态信息
   switchStreamType(String type)	改变串流类型 streamType枚举： DATA：仅数据传输通道 VIDEO：仅拉取视频流，不拉取音频流，包含DATA AUDIO：仅拉取音频流，不拉取视频流，包含DATA BOTH：启动后音视频正常拉流，默认，包含DATA
   void setPlayerCallback(Callback callback)	串流回调注册
   void setUnPlayerCallback(Callback callback)	串流回调注销，断开串流需要移除
   void stop()	主动断开串流调用该方法
   String version()	获取当前版本号
   boolean setProfile(int level)	设置清晰度档位。0：自动，1：流畅，2：高清，3：超清
   void mute(boolean mute)	设置静音
   boolean isPlaying()	判断当前是否串流中
   sendExtMessageToCloud(String message)	发送消息到云端App。message消息体（json格式的字符串）
   setCloudScreenAspect(int screenWidth, int screenHeight)	动态设置云机画面比例。screenWidth：真机屏幕宽，screenHeight：真机屏幕高
   void enableAudioKeeping(boolean isKeep)	保持后台保活
   void setSensorEvent(boolean isLandscape);	设置串流横屏或者竖屏显示。true：横屏，false：竖屏
   sendKeyEvent（int keycode）	KeyEvent.KEYCODE_BACK，KeyEvent.KEYCODE_HOME，KeyEvent.KEYCODE_APP_SWITCH

   1. 在MainActivity中根据接口获取到的token与设备信息组装串流参数打开数据通道串流。

        public void jumpTargetApp(ApiResponse authResponseResponseBean) {
              Bundle bundle = new Bundle();
              if (authResponseResponseBean != null && null != authResponseResponseBean.getData()) {
                  ApiResponse.Data data = authResponseResponseBean.getData();
                  //校验token，后台返回 如果云机校验失败会返回100002异常码
                  bundle.putString(CLOUD_APP_LAUNCH_KEY_TOKEN, TextUtils.isEmpty(data.getDevice_token()) ? "" : data.getDevice_token());
                  ApiResponse.Data.Resource resource = data.getResource();
                  if (null != resource) {
                      ApiResponse.Data.Resource.Sdk sdk = resource.getSdk();
                      if (null != sdk) {
                          ApiResponse.Data.Resource.Sdk.External external = sdk.getExternal();
                          if (null != external) {
                              //address 云机ip，后台返回
                              bundle.putString(CLOUD_APP_LAUNCH_KEY_ADDRESS, external.getAddress());
                              //aport:云机端口，后台返回
                              bundle.putInt(CLOUD_APP_LAUNCH_KEY_PORT, external.getAport());
                              //atype:后台返回
      //                        bundle.putInt(CLOUD_APP_LAUNCH_KEY_TYPE, external.getAtype());
                              bundle.putInt(CLOUD_APP_LAUNCH_KEY_TYPE, 8);
                              bundle.putInt(CLOUD_APP_LAUNCH_KEY_V_TYPE, 8);
                          }
                      }
                  }
              }
              //后台返回，有就填
      //        bundle.putString(CLOUD_APP_LAUNCH_KEY_BUILD_DEVICE,"");
              // 强制开启H264
      //        bundle.putInt(CLOUD_APP_LAUNCH_KEY_VENC_TYPE, 0);
              // 强制开启H265
              bundle.putInt(CLOUD_APP_LAUNCH_KEY_VENC_TYPE, 1);
              bundle.putInt(CLOUD_APP_LAUNCH_KEY_PROFILE_LEVEL, PROFILE_SPEED);
              //多云机共用用户id，可用用户登录id，也可自定义，保证不与其他用户相同
              bundle.putString("userId", "43740902807");
              bundle.putBoolean(CLOUD_APP_HIDE_STREAM_AT_START_UP, true);
      //        if (!TextUtils.isEmpty(pkg)) {
      //            bundle.putString("pkgs", pkg);
      //        }
              //开启
              bundle.putBoolean("free_aspect", true);
              bundle.putInt("screen_width", 1920);//任意分辨率宽
              bundle.putInt("screen_height", 1080);//任意分辨率高
              CloudPhoneClient.setPlayerType(HMTP_PLAYER);
              CloudPhoneCallBack callBack = CloudPhoneCallBack.getInstance();
              callBack.setStartHandler(v->onStreamStarted());
              callBack.setAppHandler(this::updateAppList);
              callBack.setStartAppHandler(v->startApp());
              CloudPhoneClient.enableAudioKeeping(true);
              CloudPhoneClient.setPlayerCallback(callBack);
              CloudPhoneClient.setAppCallback(callBack);
              //执行串流的，串流结果成功会从onSuccsss返回通知，失败则是onFailure带code
              CloudPhoneClient.start(null, bundle);
          }

   2. 串流回调结果Callback。

      需要在串流界面内注册Callback。

      1. 注册用回调CloudPhoneClient.setPlayerCallback(new Callback())。
      2. 注册应用操作回调。

         CloudPhoneClient.setAppCallback(callBack);

      3. 退出云机注销CloudPhoneClient.setUnPlayerCallback(this)。
   3. 接受到串流回调onStreamStarted加载应用墙。