API Interface Description

ArmCloudEngine.prepare(mContext: Application, cloudCoreManagerStatusListener: ICloudCoreManagerStatusListener)

class MyApp : Application() {

    override fun onCreate() {
        super.onCreate()
        ArmCloudEngine.prepare(this, object : ICloudCoreManagerStatusListener {
            override fun onPrepared() {
                Log.i("ArmCloudEngine", "Initialization complete")
            }
        })
    }
}

ArmCloudEngine.engineState

ArmCloudEngine.start(config: PhonePlayConfig, playerListener: IPlayerListener)

val builder: PhonePlayConfig.Builder = PhonePlayConfig.Builder()
builder.context(this)
    .userId(dto.userId) // Required: Custom client user ID
    .padCode(dto.padCode) // Required: Cloud phone instance ID
    .token(dto.token) // Required: Temporary auth token
    .clientType(dto.clientType) // Required: Client type
    .container(container) // Required: Container for rendering (must be FrameLayout or subclass)
    .enableMultiControl(isMultiControl) // Optional: Enable multi-control
    .setPadCodes(mChosePadCodes) // Optional: Multi-control device codes
    .rotation(rotation) // Optional: Screen orientation (default portrait)
    .videoStreamProfileId(
        videoStreamProfileId.definition,
        videoStreamProfileId.frameRate,
        videoStreamProfileId.bitrate
    ) // Optional: Resolution profile (default HD)
    .enableGyroscopeSensor(enableGyroscopeSensor) // Optional: Gyroscope
    .enableAccelerometerSensor(enableAccelerometerSensor) // Optional: Accelerometer
    .enableVibrator(enableVibrator) // Optional: Vibrator
    .enableLocationService(enableLocationService) // Optional: Location service
    .enableLocalKeyboard(enableLocalKeyboard) // Optional: Local keyboard
    .enableClipboardCloudPhoneSync(enableCloudSync) // Optional: Cloud → local clipboard sync (default true)
    .enableClipboardLocalPhoneSync(enableLocalSync) // Optional: Local → cloud clipboard sync (default true)
    .enableCamera(enableCamera) // Optional: Camera permission (default true)
    .enableMic(enableMic) // Optional: Mic permission (default false)
    .streamType(streamType) // Optional: Stream type (default audio+video)
    .videoRenderMode(renderMode) // Optional: Video render mode (default fit)
    .videoRotationMode(videoRotationMode) // Optional: Video rotation mode (default external)
    .autoRecycleTime(autoRecyclerTime.toInt())
    // Stream listener
    .streamListener(object : IStreamListener {
        override fun onFirstAudioFrame(uid: String) {
            runOnUiThread {
                Toast.makeText(
                    this@MainActivity,
                    "First audio frame received",
                    Toast.LENGTH_SHORT
                ).show()
            }
        }
        
        override fun onRemoteAudio(byteBuffer: ByteBuffer) {
        }

        override fun onFirstRemoteVideoFrame(uid: String, width: Int, height: Int) {
            runOnUiThread {
                Toast.makeText(
                    this@MainActivity,
                    "First video frame received",
                    Toast.LENGTH_SHORT
                ).show()
            }
        }

        override fun onVideoSizeChanged(uid: String, width: Int, height: Int) {
        }

        override fun onStreamPaused() {
            runOnUiThread {
                Toast.makeText(
                    this@MainActivity,
                    "Stream paused callback",
                    Toast.LENGTH_SHORT
                ).show()
            }
        }

        override fun onStreamConnectionStateChanged(state: Int, reason: Int) {
            runOnUiThread {
                Toast.makeText(
                    this@MainActivity,
                    "Stream connection state changed: $state",
                    Toast.LENGTH_SHORT
                ).show()
            }
        }

        override fun onScreenRotation(rotationType: Int) {
            runOnUiThread {
                requestedOrientation =
                    if (rotationType == ScreenRotationType.TYPE_PORTRAIT) ActivityInfo.SCREEN_ORIENTATION_PORTRAIT else ActivityInfo.SCREEN_ORIENTATION_LANDSCAPE
                Toast.makeText(
                    this@MainActivity,
                    "Screen rotation: ${if (rotationType == ScreenRotationType.TYPE_PORTRAIT) "Portrait" else "Landscape"}",
                    Toast.LENGTH_SHORT
                ).show()
            }
        }
    })

ArmCloudEngine.start(builder.build(), object : IPlayerListener {
    override fun onPlaySuccess(videoStreamProfileId: Int) {
        Log.e("am", "onPlaySuccess ===> videoStreamProfileId: $videoStreamProfileId")
        runOnUiThread {
            tvRoomId?.text = "Current room: ${builder.padCode}"
            Toast.makeText(this@MainActivity, "Stream success", Toast.LENGTH_SHORT).show()
        }
        initListener()
    }

    override fun onError(code: Int, msg: String) {
        runOnUiThread {
            Toast.makeText(
                this@MainActivity,
                "onError code：$code msg: $msg ",
                Toast.LENGTH_SHORT
            ).show()
        }
    }

    override fun onWarning(code: Int, msg: String) {
        runOnUiThread {
            Toast.makeText(
                this@MainActivity,
                "onWarning code：$code  $msg ",
                Toast.LENGTH_SHORT
            ).show()
        }
    }

    override fun onNetworkChanged(var1: Int) {
        runOnUiThread {
            Toast.makeText(
                this@MainActivity,
                "onNetworkChanged code：$var1",
                Toast.LENGTH_SHORT
            ).show()
        }
    }

    override fun onServiceInit(extras: Map<String, Any>?) {
        runOnUiThread {
            ArmCloudEngine.getClipBoardServiceManager()?.setBoardSyncClipListener(object :
                IClipBoardListener {
                override fun onClipBoardMessageReceived(data: String) {
                    Toast.makeText(
                        this@MainActivity,
                        "Clipboard message received: $data",
                        Toast.LENGTH_SHORT
                    ).show()
                }
            })
            Toast.makeText(this@MainActivity, "onServiceInit", Toast.LENGTH_SHORT).show()
        }
    }

    override fun networkQualityRtt(rtt: Int) {
        runOnUiThread {
            tvQuality?.text = "NetworkQuality: $rtt ms"
            Toast.makeText(this@MainActivity, "networkQualityRtt $rtt", Toast.LENGTH_SHORT).show()
        }
    }

    override fun onMultiCloudPhoneJoin(padCode: String) {
        runOnUiThread {
            ToastUtils.showShort("Multi-control user joined")
        }
    }

    override fun onMultiCloudPhoneLeave(padCode: String) {
        runOnUiThread {
            ToastUtils.showShort("Multi-control user left")
        }
    }
})

ArmCloudEngine.resume()

override fun onResume() {
    super.onResume()
    ArmCloudEngine.resume()
}

ArmCloudEngine.pause()

override fun onPause() {
    super.onPause()
    ArmCloudEngine.pause()
}

ArmCloudEngine.stop()

override fun onDestroy() {
    super.onDestroy()
    ArmCloudEngine.stop()
}

ArmCloudEngine.onRequestPermissionsResult(requestCode, permissions, grantResults)

override fun onRequestPermissionsResult(
    requestCode: Int,
    permissions: Array<String?>,
    grantResults: IntArray
) {
    super.onRequestPermissionsResult(requestCode, permissions, grantResults)
    ArmCloudEngine.onRequestPermissionsResult(requestCode, permissions, grantResults)
}

ArmCloudEngine.screenShot(@ScreenShotType screenShotType: Int)

ArmCloudEngine.videoStreamProfileId(videoDefinitionEnum: VideoDefinitionEnum)

ArmCloudEngine.videoStreamProfileId(definition: String, frameRateId: String, bitrateId: String)

ArmCloudEngine.rotate(ScreenRotationType.TYPE_LANDSCAPE)

ArmCloudEngine.muteAudio(isMetuAudio)

ArmCloudEngine.muteVideo(isMetuVideo)

ArmCloudEngine.enableLocalKeyboard(isEnable)

ArmCloudEngine.enableLocationService(isEnable)

ArmCloudEngine.enableGyroscopeSensor(isEnable)

ArmCloudEngine.enableAccelerometerSensor(isEnable)

ArmCloudEngine.enableVibrator(isEnable)

ArmCloudEngine.enableCamera(isEnable)

ArmCloudEngine.enableMic(isEnable)

ArmCloudEngine.setLocationServiceMode(mode@LocationMode)

ArmCloudEngine.getLocationServer()

ArmCloudEngine.getClipBoardServiceManager()

ArmCloudEngine.switchCamera(isBack)

ArmCloudEngine.sendKeyEvent(systemKeyStrokeEnum: SystemKeyStrokeEnum)

ArmCloudEngine.autoRecycleTime(recycleTime)

ArmCloudEngine.getAutoRecycleTime()

ArmCloudEngine.streamType(streamType)

ArmCloudEngine.updateVideoRenderMode(renderMode)

ArmCloudEngine.setVideoRotationMode(rotationMode)

ArmCloudEngine.getStatus()

ArmCloudEngine.getMessageChannel()

ArmCloudEngine.getUploadManager(application)

ArmCloudEngine.getLocalInputManager()

ArmCloudEngine.startCaptureVideo()

ArmCloudEngine.startCaptureAudio()

ArmCloudEngine.stopCaptureVideo()

ArmCloudEngine.stopCaptureAudio()

ArmCloudEngine.startInjectVideoStream(path: String, isLoop: Boolean, fileName: String?)

ArmCloudEngine.stopInjectVideoStream()

ArmCloudEngine.getVideoInjectState()

setStreamProfileChangeListener(streamProfileChangeCallBack: StreamProfileChangeCallBack)

ArmCloudEngine.setStreamProfileChangeListener(object : StreamProfileChangeCallBack {
    override fun onVideoStreamProfileChange(
        isSuccess: Boolean,
        from: String,
        current: String
    ) {
        runOnUiThread {
            Toast.makeText(
                this@MainActivity,
                "Resolution change success from：$from to:$current",
                Toast.LENGTH_SHORT
            ).show()
        }
    }
})

setAutoRecycleTimeCallback(autoRecycleTimeCallback: SetAutoRecycleTimeCallback)

ArmCloudEngine.setAutoRecycleTimeCallback(object : SetAutoRecycleTimeCallback {
    override fun onResult(autoRecycleTime: Int) {
        runOnUiThread {
            Toast.makeText(
                this@MainActivity,
                "Idle recycle callback timeout：$autoRecycleTime",
                Toast.LENGTH_SHORT
            ).show()
        }
    }
})

setScreenShotCallBack(screenShotCallBack: ScreenShotCallBack)

ArmCloudEngine.setScreenShotCallBack(object : ScreenShotCallBack {
    override fun onScreenShot(bitmap: Bitmap) {
        runOnUiThread {
            Toast.makeText(
                this@MainActivity,
                "Local screenshot received：${bitmap.byteCount}",
                Toast.LENGTH_SHORT
            ).show()
        }
    }
})

setLocationEventListener(locationEventListener: LocationEventListener)

ArmCloudEngine.setLocationEventListener(object : LocationEventListener {

    override fun onReceivedRemoteLocationRequest(requestOptions: RequestOptions) {
        runOnUiThread {
            Toast.makeText(
                this@MainActivity,
                "Cloud phone requests location permission",
                Toast.LENGTH_SHORT
            ).show()
        }
    }

    override fun onRemoteLocationRequestEnded() {
        runOnUiThread {
            Toast.makeText(
                this@MainActivity,
                "Cloud phone stops location request",
                Toast.LENGTH_SHORT
            ).show()
        }
    }

    override fun onSentLocalLocation(locationInfo: LocationInfo) {
        runOnUiThread {
            Toast.makeText(
                this@MainActivity,
                "Local location sent",
                Toast.LENGTH_SHORT
            ).show()
        }
    }

    override fun onRemoteLocationUpdated(locationInfo: LocationInfo) {
        runOnUiThread {
            Toast.makeText(
                this@MainActivity,
                "Cloud location updated",
                Toast.LENGTH_SHORT
            ).show()
        }
    }
})

setExecuteAdbCommandCallback(iExecuteAdbCommandCallback: IExecuteAdbCommandCallback)

ArmCloudEngine.setExecuteAdbCommandCallback(object : IExecuteAdbCommandCallback {
    override fun onExecuteAdbCommandResult(isSuccess: Boolean, content: String) {
        ToastUtils.showShort("ADB command executed isSuccess: $isSuccess resultMsg: $content")
        Log.e(
            TAG,
            "onExecuteAdbCommandResult isSuccess ===> $isSuccess  content ===> $content"
        )
    }
})

setInjectVideoListener(iInjectVideoListener: IInjectVideoListener)

ArmCloudEngine.setInjectVideoListener(object : IInjectVideoListener {
    override fun onInjectCallBack(code: String, content: String) {
        Log.e(
            TAG,
            "onInjectCallBack code: $code  content: $content"
        )
        ToastUtils.showShort(content)
    }

    override fun onVideoInjectInfo(@VideoInjectState state: Int, videoPath: String?) {
        Log.e(
            TAG,
            "videoInjectState state: $state"
        )
        ToastUtils.showShort("videoInjectState state: $state  videoPath: $videoPath")
    }
})