tencent cloud

Mobile Live Video Broadcasting

DocumentaçãoMobile Live Video BroadcastingClient APIsAndroidDeviceStore

DeviceStore

Baixar
Modo Foco
Tamanho da Fonte
Última atualização: 2026-11-02 17:47:29

Introduction

DeviceStore provides a comprehensive set of APIs to manage audio and video devices, including microphone, camera and screen sharing features.
Notice:
Use DeviceStore.shared singleton to get the DeviceStore instance. Do not attempt to initialize directly.
Note:
Device state updates are delivered through the deviceState publisher. Subscribe to it to receive real-time updates about microphone, camera, network and other states.

Features

Microphone Management: Open/close microphone, set capture volume and output volume.
Camera Management: Open/close camera, switch front/rear camera, set mirror and video quality.
Audio Route: Switch between speaker and earpiece.
Network Status: Real-time monitoring of network quality information.

Subscribable Data

DeviceState fields are described below:
Property
Type
Description
microphoneStatus
StateFlow<DeviceStatus>
Microphone status.
microphoneLastError
StateFlow<DeviceError>
Microphone error, used to extract error information when an error occurs.
captureVolume
StateFlow<Int>
Capture volume, with a value range from 0 to 100.
currentMicVolume
StateFlow<Int>
Current user's actual output volume.
outputVolume
StateFlow<Int>
Maximum output volume, with a value range from 0 to 100.
cameraStatus
StateFlow<DeviceStatus>
Camera status.
cameraLastError
StateFlow<DeviceError>
Camera error, used to extract error information when an error occurs.
isFrontCamera
StateFlow<Boolean>
Whether it's front camera.
localMirrorType
StateFlow<MirrorType>
Mirror state.
localVideoQuality
StateFlow<VideoQuality>
Local video quality.
currentAudioRoute
StateFlow<AudioRoute>
Current audio route location.
screenStatus
StateFlow<DeviceStatus>
Screen sharing status.
networkInfo
StateFlow<NetworkInfo>
Network information.
networkType
StateFlow<NetworkType>
Current network type.
microphoneList
StateFlow<List<DeviceInfo>>
Current microphone device list. Only populated on desktop platforms, it is empty on mobile platforms.
currentMicrophone
StateFlow<DeviceInfo>
Current microphone device, an empty deviceId means no microphone is selected.
microphoneVolume
StateFlow<Int>
Microphone capture volume, with a value range from 0 to 100.
microphoneInputLevel
StateFlow<Int>
Real-time level value used to display the microphone volume bar, range 0-100.
Only updated while the microphone test is running, see startMicrophoneTest.
cameraList
StateFlow<List<DeviceInfo>>
Camera device list. On desktop platforms it contains all the cameras, on mobile platforms it contains the logical front camera and rear camera.
currentCamera
StateFlow<DeviceInfo>
Current camera device, an empty deviceId means no camera is selected.
speakerList
StateFlow<List<DeviceInfo>>
Speaker device list. On desktop platforms it contains all the speakers, on mobile platforms it contains the logical speaker and earpiece.
currentSpeaker
StateFlow<DeviceInfo>
Current speaker device, an empty deviceId means no speaker is selected.
speakerVolume
StateFlow<Int>
Speaker playback volume, with a value range from 0 to 100.
speakerOutputLevel
StateFlow<Int>
Speaker real-time output level value, range 0-100.
Only updated while the speaker test is running, see startSpeakerTest.

API List

Function
Description
Singleton object.
Open local microphone.
Close local microphone.
Set microphone capture volume.
Set speaker playback volume.
Select microphone device.
Start microphone test.
Stop microphone test.
Select speaker device.
Start speaker test.
Stop speaker test.
Start camera test.
Stop camera test.
Open local camera.
Close local camera.
Select camera device.
Switch mirror state.
Update video quality.
Set capture volume, use setMicrophoneVolume instead.
Set output volume, use setSpeakerVolume instead.
Set audio route, use setCurrentSpeaker instead.
Switch camera, use setCurrentCamera instead.
reset
Reset to default state.

Getting Instance

DeviceStore.shared

Singleton object.

Microphone Operations

openLocalMicrophone

Open local microphone.
abstract fun openLocalMicrophone(completion: CompletionHandler?)
Version
Supported since version 3.5.
Parameters
Parameter
Type
Description
completion
Whether operation succeeded.

closeLocalMicrophone

Close local microphone.
abstract fun closeLocalMicrophone()
Version
Supported since version 3.5.

setMicrophoneVolume

Set microphone capture volume.
abstract fun setMicrophoneVolume(volume: Int)
Version
Supported since version 3.5.
Parameters
Parameter
Type
Description
volume
Int
Capture volume, with a value range from 0 to 100.

setSpeakerVolume

Set speaker playback volume.
abstract fun setSpeakerVolume(volume: Int)
Version
Supported since version 3.5.
Parameters
Parameter
Type
Description
volume
Int
Playback volume, with a value range from 0 to 100.

setCurrentMicrophone

Set current microphone device.
Only supported on desktop platforms, mobile platforms do not allow switching the microphone device and calling it has no effect there. It takes effect only when the microphone is on.
abstract fun setCurrentMicrophone(microphone: DeviceInfo)
Version
Supported since version 3.5.
Parameters
Parameter
Type
Description
microphone
Microphone device, an element of microphoneList.

startMicrophoneTest

Start microphone test, the capture level is reported to microphoneInputLevel in real time, with a capture interval in milliseconds.
abstract fun startMicrophoneTest(interval: Int)
Version
Supported since version 3.5.
Parameters
Parameter
Type
Description
interval
Int
Capture interval in milliseconds. Default is 200ms.

stopMicrophoneTest

Stop microphone test.
abstract fun stopMicrophoneTest()
Version
Supported since version 3.5.

Speaker Operations

setCurrentSpeaker

Set current speaker device.
abstract fun setCurrentSpeaker(speaker: DeviceInfo)
Supported on all platforms: on desktop platforms any device in speakerList can be selected, on mobile platforms only the logical speaker/earpiece switch takes effect.
Version
Supported since version 3.5.
Parameters
Parameter
Type
Description
speaker
Speaker device, an element of speakerList.

startSpeakerTest

Start speaker test, the playback level is reported to speakerOutputLevel in real time.
An audio file is played during the test, the speaker device in use can be verified.
abstract fun startSpeakerTest(filePath: String)
Version
Supported since version 3.5.
Parameters
Parameter
Type
Description
filePath
String
Audio file path used for the test playback. Required; an empty value returns an invalid-parameter error.

stopSpeakerTest

Stop speaker test.
abstract fun stopSpeakerTest()
Version
Supported since version 3.5.

Camera Operations

startCameraTest

Start camera test, if camera opens successfully, the view will be rendered to the set CameraView.
abstract fun startCameraTest(cameraView: CameraView, completion: CompletionHandler?)
Version
Supported since version 3.5.
Parameters
Parameter
Type
Description
cameraView
Render view id for camera capture, obtained from CameraView.onViewCreated. Pass 0 to set no render target.
completion
Whether operation succeeded.

stopCameraTest

Stop camera test.
abstract fun stopCameraTest()
Version
Supported since version 3.5.

openLocalCamera

Open local camera.
abstract fun openLocalCamera(isFront: Boolean, completion: CompletionHandler?)
Version
Supported since version 3.5.
Parameters
Parameter
Type
Description
isFront
Boolean
Whether front camera.
completion
Whether operation succeeded.

closeLocalCamera

Close local camera.
abstract fun closeLocalCamera()
Version
Supported since version 3.5.

setCurrentCamera

Set current camera device.
Supported on all platforms: on desktop platforms any device in cameraList can be selected, on mobile platforms it is equivalent to switching between the front and rear cameras.
It takes effect only when the camera is on.
abstract fun setCurrentCamera(camera: DeviceInfo)
Version
Supported since version 3.5.
Parameters
Parameter
Type
Description
camera
Camera device, an element of cameraList.

switchMirror

Switch mirror state.
abstract fun switchMirror(mirrorType: MirrorType)
Version
Supported since version 3.5.
Parameters
Parameter
Type
Description
mirrorType
Mirror state.

updateVideoQuality

Update video quality.
abstract fun updateVideoQuality(quality: VideoQuality, orientation: VideoOrientation = VideoOrientation.PORTRAIT)
Version
Supported since version 3.5.
Parameters
Parameter
Type
Description
quality
Video quality.
orientation
Video orientation. Defaults to portrait. Pass landscape to use the base (width x height) resolution.

Deprecated

setCaptureVolume

Set capture volume (deprecated, use setMicrophoneVolume instead).
Warning:
Deprecated: Use setMicrophoneVolume instead. Will be removed in version 5.5.
@Deprecated("Use setMicrophoneVolume instead. Will be removed in version 5.5.")
abstract fun setCaptureVolume(volume: Int)
Version
Supported since version 3.5.
Parameters
Parameter
Type
Description
volume
Int
Capture volume, with a value range from 0 to 100.

setOutputVolume

Set maximum output volume (deprecated, use setSpeakerVolume instead).
Warning:
Deprecated: Use setSpeakerVolume instead. Will be removed in version 5.5.
@Deprecated("Use setSpeakerVolume instead. Will be removed in version 5.5.")
abstract fun setOutputVolume(volume: Int)
Version
Supported since version 3.5.
Parameters
Parameter
Type
Description
volume
Int
Maximum volume, with a value range from 0 to 100.

setAudioRoute

Set audio route (deprecated, use setCurrentSpeaker instead).
Warning:
Deprecated: Use setCurrentSpeaker instead. Will be removed in version 5.5.
@Deprecated("Use setCurrentSpeaker instead. Will be removed in version 5.5.")
abstract fun setAudioRoute(audioRoute: AudioRoute)
Version
Supported since version 3.5.
Parameters
Parameter
Type
Description
audioRoute
Route location.

switchCamera

Switch camera (deprecated, use setCurrentCamera instead).
Warning:
Deprecated: Use setCurrentCamera instead. Will be removed in version 5.5.
@Deprecated("Use setCurrentCamera instead. Will be removed in version 5.5.")
abstract fun switchCamera(isFront: Boolean)
Version
Supported since version 3.5.
Parameters
Parameter
Type
Description
isFront
Boolean
Whether front camera.

Reset

reset

Reset to default state.
abstract fun reset()
Version
Supported since version 3.5.

Data Structures

DeviceType

Device type.
Enum Value
Value
Description
MICROPHONE
1
Microphone type.
CAMERA
2
Camera type.
SCREEN_SHARE
3
Screen sharing type.

DeviceError

Device related error codes.
Enum Value
Value
Description
NO_ERROR
0
Operation successful.
NO_DEVICE_DETECTED
1
No device detected.
NO_SYSTEM_PERMISSION
2
No system permission.
NOT_SUPPORT_CAPTURE
3
Capture not supported.
OCCUPIED_ERROR
4
Device occupied.
UNKNOWN_ERROR
5
Unknown error.

DeviceStatus

Device on/off status.
Enum Value
Value
Description
OFF
0
Off.
ON
1
On.

AudioRoute

Audio route.
Enum Value
Value
Description
SPEAKERPHONE
0
Speaker, using speaker to play (i.e., "hands-free"), located at the bottom of the phone, louder sound, suitable for playing music out loud.
EARPIECE
1
Earpiece, using earpiece to play, located at the top of the phone, quieter sound, suitable for private call scenarios.

VideoQuality

Video quality level. The final encoding resolution is determined by the combination of this level and VideoOrientation: landscape keeps the base resolution (width x height), portrait swaps the width and height.
Enum Value
Value
Description
QUALITY_360P
1
360P. Landscape resolution is 640 x 360; portrait (width and height swapped) is 360 x 640.
QUALITY_540P
2
540P. Landscape resolution is 960 x 540; portrait (width and height swapped) is 540 x 960.
QUALITY_720P
3
720P. Landscape resolution is 1280 x 720; portrait (width and height swapped) is 720 x 1280.
QUALITY_1080P
4
1080P. Landscape resolution is 1920 x 1080; portrait (width and height swapped) is 1080 x 1920.

VideoOrientation

Video orientation. Combined with VideoQuality to determine the final encoding resolution: landscape keeps the base resolution (width x height), portrait swaps the width and height.
Enum Value
Value
Description
LANDSCAPE
0
Landscape, the encoding resolution width is greater than the height (e.g. 1280 x 720).
PORTRAIT
1
Portrait, the encoding resolution height is greater than the width (e.g. 720 x 1280).

NetworkQuality

Network quality.
Enum Value
Value
Description
UNKNOWN
0
Unknown network.
EXCELLENT
1
Excellent.
GOOD
2
Good.
POOR
3
Poor.
BAD
4
Bad.
VERY_BAD
5
Very bad.
DOWN
6
Disconnected.

MirrorType

Camera mirror state.
Enum Value
Value
Description
AUTO
0
Auto, front camera mirrored, rear camera not mirrored.
ENABLE
1
Both front and rear cameras mirrored.
DISABLE
2
Neither front nor rear camera mirrored.

NetworkType

Network type.
Enum Value
Value
Description
UNKNOWN
0
Unknown or unidentified network type.
WIFI
1
WiFi network connection.
CELLULAR
2
Cellular/mobile data network connection.

DeviceInfo

Device information.
Property
Type
Description
deviceId
String
Device ID.
deviceName
String
Device name.

NetworkInfo

Network information.
Property
Type
Description
userID
String
User unique ID.
quality
Network quality.
upLoss
Int
Uplink packet loss rate, with a value range from 0 to 100.
downLoss
Int
Downlink packet loss rate, with a value range from 0 to 100.
delay
Int
Latency (unit: milliseconds).

DeviceState

Device state.
Property
Type
Description
microphoneStatus
StateFlow<DeviceStatus>
Microphone status.
microphoneLastError
StateFlow<DeviceError>
Microphone error, used to extract error information when an error occurs.
captureVolume
StateFlow<Int>
Capture volume, with a value range from 0 to 100.
currentMicVolume
StateFlow<Int>
Current user's actual output volume.
outputVolume
StateFlow<Int>
Maximum output volume, with a value range from 0 to 100.
cameraStatus
StateFlow<DeviceStatus>
Camera status.
cameraLastError
StateFlow<DeviceError>
Camera error, used to extract error information when an error occurs.
isFrontCamera
StateFlow<Boolean>
Whether it's front camera.
localMirrorType
StateFlow<MirrorType>
Mirror state.
localVideoQuality
StateFlow<VideoQuality>
Local video quality.
currentAudioRoute
StateFlow<AudioRoute>
Current audio route location.
screenStatus
StateFlow<DeviceStatus>
Screen sharing status.
networkInfo
StateFlow<NetworkInfo>
Network information.
networkType
StateFlow<NetworkType>
Current network type.
microphoneList
StateFlow<List<DeviceInfo>>
Current microphone device list. Only populated on desktop platforms, it is empty on mobile platforms.
currentMicrophone
StateFlow<DeviceInfo>
Current microphone device, an empty deviceId means no microphone is selected.
microphoneVolume
StateFlow<Int>
Microphone capture volume, with a value range from 0 to 100.
microphoneInputLevel
StateFlow<Int>
Real-time level value used to display the microphone volume bar, range 0-100.
Only updated while the microphone test is running, see startMicrophoneTest.
cameraList
StateFlow<List<DeviceInfo>>
Camera device list. On desktop platforms it contains all the cameras, on mobile platforms it contains the logical front camera and rear camera.
currentCamera
StateFlow<DeviceInfo>
Current camera device, an empty deviceId means no camera is selected.
speakerList
StateFlow<List<DeviceInfo>>
Speaker device list. On desktop platforms it contains all the speakers, on mobile platforms it contains the logical speaker and earpiece.
currentSpeaker
StateFlow<DeviceInfo>
Current speaker device, an empty deviceId means no speaker is selected.
speakerVolume
StateFlow<Int>
Speaker playback volume, with a value range from 0 to 100.
speakerOutputLevel
StateFlow<Int>
Speaker real-time output level value, range 0-100.
Only updated while the speaker test is running, see startSpeakerTest.

Usage Example

// Get singleton instance
val store = DeviceStore.shared()
// Subscribe to state changes
lifecycleScope.launch {
    store.deviceState.microphoneStatus.collect { status ->
        println("Microphone status: $status")
    }
}
lifecycleScope.launch {
    store.deviceState.cameraStatus.collect { status ->
        println("Camera status: $status")
    }
}
// Open microphone
store.openLocalMicrophone { code, message ->
    if (code == 0) {
        println("Microphone opened successfully")
    }
}
// Open front camera
store.openLocalCamera(isFront = true) { code, message ->
    if (code == 0) {
        println("Camera opened successfully")
    }
}

Anterior: CoHostStorePróximo: GiftStore

Ajuda e Suporte

Esta página foi útil?

comentários

Search
    Enter keywords to search documentation