文档首页 > > SDK参考> Android SDK> 接口参考> 数据类型

数据类型

分享
更新时间:2020/11/26 GMT+08:00

本章节列出了Android SDK的所有数据类型,您可以结合RtcEngine接口和回调进行开发。

表1 数据类型

类型

描述

HRTCLogInfo

日志信息

HRTCUserInfo

用户信息

HRTCStatsInfo

卡顿统计信息

HRTCVideoEncParam

视频编码参数列表

HRTCLocalVideoStats

本地视频流信息

HRTCLocalAudioStats

本地音频流信息

HRTCRemoteVideoStats

远端视频流信息

HRTCRemoteAudioStats

远端音频流信息

HRTCConnectInfo

跨房信息

HRTCVideoFrame

视频帧信息

HRTCLogLevel

日志级别

HRTCMediaType

媒体类型

HRTCSpeakerModel

声音播放模式

HRTCAudioRoute

音频路由

HRTCStreamType

流类型

HRTCRoleType

角色类型

HRTCVideoDisplayMode

图像填充模式

HRTCConnStateTypes

网络连接状态

HRTCConnChangeReason

网络连接状态发生变化原因

HRTCRotationType

辅流角度

HRTCVideoFrameFormat

视频格式

HRTCLeaveReason

离开房间的原因

HRTCVideoMirrorType

镜像模式类型

HRTCRemoteAudioStreamStateReason

远端音频流状态发生变化原因

HRTCRemoteAudioStreamState

远端音频流状态

HRTCRemoteVideoStreamState

远端视频流状态

HRTCRemoteVideoStreamStateReason

远端视频流状态发生变化原因

HRTCVolumeInfo

发言人音量

HRTCNetworkTestConfig

网络探测参数

HRTCNetworkTestResult

网络探测结果数据

HRTCNetworkQualityLevel

网络质量级别

HRTCNetworkTestState

网络探测结果状态

HRTCNetworkTestResultParam

网络探测结果参数

HRTCMediaDirection

媒体方向指示。

HRTCLogInfo

表2 日志信息

属性

类型

描述

level

HRTCLogLevel

日志级别

path

String

日志存储路径

HRTCUserInfo

表3 用户信息

属性

类型

描述

userId

String

用户ID

userName

String

用户名,可选

ctime

long

签名时间戳,可选

signature

String

签名,可选,具体生成方法请参考接入鉴权

role

HRTCRoleType

角色

optionalInfo

String

可选JSON字串 [{key:param1,value:value1},{key:param2,value:value2}]

HRTCStatsInfo

表4 统计信息

属性

类型

描述

mildlyFrozenCounts

long

600ms卡顿次数

severelyFrozenCounts

long

超过1s卡顿次数

totalMildlyFrozenTime;

long

600ms卡顿总时长

totalSeverelyFrozenTime

long

1s卡顿总时长

totalActiveTime

long

总时间,包括每一路选看的视频流启动到停止的时间总和

HRTCVideoEncParam

表5 视频编码参数属性说明

属性

类型

描述

streamType

HRTCStreamType

视频流类型

width

int

视频宽度

height

int

视频高度

frameRate

int

视频帧率

minFrameRate

int

视频最小帧率

bitrate

int

视频码率

minBitrate

int

视频最小码率

disableAdjustRes

boolean

禁用码率自适应标志

表6 视频编码参数方法说明

方法

描述

public HRTCVideoEncParam(HRTCStreamType streamType, int width, int height, int frameRate, int minFrameRate, int bitrate, int minBitrate, boolean disableAdjustRes);

【功能说明】

HRTCVideoEncParam构造函数。

【请求参数】

streamType:视频流类型,具体请参见HRTCStreamType

width:视频宽度

height:视频高度

frameRate:视频帧率

minFrameRate:视频最小帧率

bitrate:视频码率

minBitrate:视频最小码率

disableAdjustRes:禁用码率自适应标志

【返回参数】

HRTCVideoEncParam类对象。

【注意事项】

无。

public HRTCStreamType getStreamType();

【功能说明】

获取视频流类型。

【请求参数】

无。

【返回参数】

视频流类型,具体参见HRTCStreamType

【注意事项】

public void setStreamType(HRTCStreamType streamType);

【功能说明】

设置视频流类型。

【请求参数】

streamType:流类型,HRTCStreamType

【返回参数】

视频流类型,具体参见HRTCStreamType

【注意事项】

表7 不同分辨率的码率和帧率配置推荐

分辨率

分辨率类型

比例

最小帧率(fps)

最大帧率(fps)

最小码率

最大码率

160 X 90

LD

16:9

10

30

64

270

320 X 180

SD

16:9

10

30

80

600

480 X 270

HD

16:9

10

30

160

1050

640 X 360

HD

16:9

10

30

200

1700

800 X 450

FHD

16:9

10

30

300

2100

960 X 540

FHD

16:9

10

30

400

2400

1120 X 630

FHD

16:9

10

30

450

2800

1280 X 720

FHD

16:9

10

30

500

4000

120 X 90

LD

4:3

10

30

64

240

160 X 120

SD

4:3

10

30

64

270

240 X 180

SD

4:3

10

30

80

450

320 X 240

HD

4:3

10

30

100

600

400 X 300

HD

4:3

10

30

200

900

480 X 360

HD

4:3

10

30

200

1000

640 X 480

FHD

4:3

10

30

250

1800

960 X 720

FHD

4:3

10

30

450

3000

表8 不同场景的码率和帧率配置推荐

分辨率

推荐帧率

通信场景推荐码率

直播场景推荐码率

160 X 90

15

90

180

320 X 180

15

200

400

480 X 270

15

350

700

640 X 360

15

450

900

640 X 360

30

850

1700

800 X 450

15

700

1400

800 X 450

30

1050

2100

960 X 540

15

850

1700

960 X 540

30

1200

2400

1120 X 630

15

950

1900

1120 X 630

30

1400

2800

1280 X 720

15

1200

2400

1280 X 720

30

2000

4000

120 X 90

15

80

160

160 X 120

15

90

180

240 X 180

15

150

300

320 X 240

15

200

400

400 X 300

15

300

600

480 X 360

15

350

700

480 X 360

30

500

1000

640 X 480

15

600

1200

640 X 480

30

900

1800

960 X 720

15

1000

2000

960 X 720

30

1500

3000

HRTCLocalVideoStats

表9 本地视频流信息详情

属性

类型

描述

width

int

视频宽

height

int

视频高

bitRate

int

视频码率

frameRate

int

视频帧率,单位:fps

packetLoss

int

视频丢包率

delay

int

时延,单位:ms

jitter

int

抖动

HRTCLocalAudioStats

表10 本地音频流信息详情

属性

类型

描述

sampleRate

int

音频采样率

channels

int

音频频道数

bitRate

int

音频码率

packetLoss

int

音频丢包率

delay

int

时延,单位:ms

jitter

int

抖动

HRTCRemoteVideoStats

表11 远端视频流信息详情

属性

类型

描述

userId

String

远端用户userId

width

int

视频宽

height

int

视频高

bitRate

int

视频码率

frameRate

int

视频帧率,单位:fps

packetLoss

int

视频丢包率

delay

int

时延,单位:ms

jitter

int

抖动

HRTCRemoteAudioStats

表12 远端音频流信息详情

属性

类型

描述

userId

String

远端用户ID

sampleRate

int

音频采样率

channels

int

音频频道数

bitRate

int

音频码率

packetLoss

int

音频丢包率

delay

int

时延,单位:ms

jitter

int

抖动

HRTCConnectInfo

表13 跨房信息

属性

类型

描述

roomId

String

跨房房间号

role

HRTCRoleType

跨房时角色,具体请参见HRTCRoleType

HRTCVideoFrame

表14 视频帧

属性

类型

描述

format

HRTCVideoFrameFormat

支持的视频格式

videoData

byte[]

视频数据

width

int

宽度

height

int

高度

HRTCLogLevel

表15 日志级别

枚举值

描述

HRTC_LOG_LEVEL_ERROR

错误级别日志

HRTC_LOG_LEVEL_WARNING

警告级别日志

HRTC_LOG_LEVEL_INFO

信息级别日志

HRTC_LOG_LEVEL_DEBUG

调试级别日志

HRTCMediaType

表16 媒体类型

枚举值

描述

HRTC_MEDIA_TYPE_AUDIO

音频

HRTC_MEDIA_TYPE_VIDEO

音频+视频

HRTCSpeakerModel

表17 声音播放模式

枚举值

描述

HRTC_SPEAKER_MODE_EARPIECE

听筒模式

HRTC_SPEAKER_MODE_SPEAKER

外放模式

HRTCAudioRoute

表18 音频路由

枚举值

描述

HRTC_AUDIO_ROUTE_SPEAKER

外放模式

HRTC_AUDIO_ROUTE_BLUETOOTH

蓝牙模式

HRTC_AUDIO_ROUTE_RECEIVER

听筒模式

HRTC_AUDIO_ROUTE_HEADSET

耳机模式

HRTCStreamType

表19 流类型

枚举值

描述

HRTC_STREAM_TYPE_LD

流畅

HRTC_STREAM_TYPE_SD

标清

HRTC_STREAM_TYPE_HD

高清

HRTC_STREAM_TYPE_FHD

全高清

HRTCRoleType

表20 用户角色

枚举值

描述

HRTC_ROLE_TYPE_JOINER

双向流角色,例如主播加入

HRTC_ROLE_TYPE_PUBLISER

发布流角色,例如广播

HRTC_ROLE_TYPE_PLAYER

接收流角色,例如观众

HRTCVideoDisplayMode

表21 图像填充模式

枚举值

描述

HRTC_VIDEO_DISPLAY_MODE_FIT

(不拉伸)黑边模式,通过扩边的方式保持宽高比。

HRTC_VIDEO_DISPLAY_MODE_HIDDEN

(不拉伸)裁剪模式,通过裁剪的方式保持宽高比。

HRTC_VIDEO_DISPLAY_MODE_FILL

视频尺寸进行缩放和拉伸以充满显示视窗

HRTC_VIDEO_DISPLAY_MODE_ADAPT

自适应模式,显示图像和设备的横竖屏不同使用黑边模式,横竖屏相同使用裁剪模式,只支持Android和iOS平台

HRTCConnStateTypes

表22 网络连接状态

枚举值

描述

HRTC_CONN_DISCONNECTED

连接断开

HRTC_CONN_CONNECTING

建立网络连接中

HRTC_CONN_CONNECTED

网络连接成功

HRTC_CONN_RECONNETING

重新建立网络连接中

HRTC_CONN_FAILED

网络连接失败

HRTCConnChangeReason

表23 网络连接状态变化原因

枚举值

描述

HRTC_CONN_CHANGED_CONNECTING

正在连接

HRTC_CONN_CHANGED_JOIN_SUCCESS

加入房间成功

HRTC_CONN_CHANGED_RECONNECTING

重连中

HRTC_CONN_CHANGED_RECONNECT_SUCCESS

重连成功

HRTC_CONN_CHANGED_JOIN_FAILED

加入房间失败

HRTC_CONN_CHANGED_RECONNCET_FAILED

重连失败

HRTC_CONN_CHANGED_INTERRUPTED

连接中断

HRTC_CONN_CHANGED_KEEP_ALIVE_TIMEOUT

心跳超时

HRTC_CONN_CHANGED_LEAVE_ROOM

主动离开房间

HRTC_CONN_CHANGED_JOIN_ROOM_SERVER_ERROR

服务器异常

HRTC_CONN_CHANGED_SFU_BREAKDOWN

sfu服务故障

HRTC_CONN_CHANGED_JOIN_ROOM_AUTH_FAILED

鉴权失败,appid或者签名错误

HRTC_CONN_CHANGED_JOIN_ROOM_AUTH_RETRY

鉴权失败,重试

HRTC_CONN_CHANGED_JOIN_ROOM_AUTH_CLOCK_SYNC

鉴权时间戳校验失败

HRTC_CONN_CHANGED_JOIN_ROOM_URL_NOT_RIGHT

URL错误 400

HRTC_CONN_CHANGED_JOIN_ROOM_SERVICE_UNREACHABLE

服务不可达503

HRTC_CONN_CHANGED_INTERNAL_ERROR

内部错误

HRTC_CONN_CHANGED_KICKED_OFF

被踢出房间

HRTC_CONN_CHANGED_SIGNATURE_EXPIRED

签名过期

HRTCRotationType

表24 旋转类型

枚举值

描述

HRTC_ROTATION_TYPE_0

不旋转

HRTC_ROTATION_TYPE_90

顺时针旋转90度

HRTC_ROTATION_TYPE_180

顺时针旋转180度

HRTC_ROTATION_TYPE_270

顺时针旋转270度

HRTCVideoFrameFormat

表25 视频帧格式

枚举值

描述

HRTC_VIDEO_FRAME_FORMAT_YUV420P

YUV420 格式

HRTCLeaveReason

表26 离开房间原因

枚举值

描述

HRTC_LEAVE_REASON_USER_LEAVE_ROOM

用户主动离开

HRTC_LEAVE_REASON_SERVER_ERROR

服务器异常

HRTC_LEAVE_REASON_BREAKDOWN

sfu服务故障

HRTC_LEAVE_REASON_SERVICE_UNREACHABLE

服务不可达

HRTC_LEAVE_REASON_INTERNAL_ERROR

内部错误

HRTC_LEAVE_REASON_KICKED_OFF

被踢

HRTC_LEAVE_REASON_SIGNATURE_EXPIRED

签名过期

HRTC_LEAVE_REASON_RECONNECT_FAILED

重连超时

HRTCVideoMirrorType

表27 视频镜像类型

枚举值

描述

HRTC_VIDEO_MIRROR_TYPE_AUTO

SDK 决定镜像方式:前置摄像头镜像,后置摄像头不镜像

HRTC_VIDEO_MIRROR_TYPE_ENABLE

前置摄像头和后置摄像头都镜像

HRTC_VIDEO_MIRROR_TYPE_DISABLE

前置摄像头和后置摄像头都不镜像

HRTCRemoteAudioStreamStateReason

表28 远端音频状态变化原因

枚举值

描述

HRTC_REMOTE_AUDIO_REASON_REMOTE_OFFLINE

远端用户离线

HRTC_REMOTE_AUDIO_REASON_REMOTE_MUTED

远端用户禁止音频流发送

HRTC_REMOTE_AUDIO_REASON_REMOTE_UNMUTED

远端用户开启音频流发送

HRTCRemoteAudioStreamState

表29 远端音频状态

枚举值

描述

HRTC_REMOTE_VIDEO_STATE_STOPPED

远端音频流关闭发送

HRTC_REMOTE_VIDEO_STATE_DECODING

远端音频正常编码发送

HRTCRemoteVideoStreamState

表30 远端视频状态

枚举值

描述

HRTC_REMOTE_VIDEO_STATE_STOPPED

远端视频流关闭发送

HRTC_REMOTE_VIDEO_STATE_DECODING

远端视频流正常编码发送

HRTCRemoteVideoStreamStateReason

表31 远端视频状态变化原因

枚举值

描述

HRTC_REMOTE_VIDEO_REASON_REMOTE_OFFLINE

远端用户离线

HRTC_REMOTE_VIDEO_REASON_REMOTE_MUTED

远端用户禁止视频流发送

HRTC_REMOTE_VIDEO_REASON_REMOTE_UNMUTED

远端用户开启视频流发送

HRTCVolumeInfo

表32 发言人音量

属性

类型

描述

roomId

String

房间ID

userId

String

用户ID。

volume

int

音量。

HRTCNetworkTestConfig

表33 网络探测参数

属性

类型

描述

userId

String

必选,用户ID。

roomId

String

房间ID,必选,建议值:userId+随机数拼接。

signature

String

签名,开启签名鉴权必选,否则可选。

ctime

long

时间戳,开启签名鉴权必选,否则可选。

enableUplinkTest

boolean

必选,是否开启上行流探测。

enableDownlinkTest

boolean

必选,是否开启上行流探测。

expectedUplinkBitrate

int

必选,用户期望的最高发送码率,单位为 bps,范围为0 以及 [100000, 5000000],设为0表示由SDK指定最高码率。

expectedDownlinkBitrate

int

必选,用户期望的最高接收码率,单位为 bps,范围为0 以及 [100000, 5000000],设为0表示由SDK指定最高码率。

HRTCNetworkTestResult

表34 网络探测结果数据

属性

类型

描述

testState

HRTCNetworkTestState

测试结果。

uplinkResult

HRTCNetworkTestResultParam

上行探测结果。

downlinkResult

HRTCNetworkTestResultParam

下行探测结果。

HRTCNetworkQualityLevel

网络质量级别的数值越大,信号越好。

表35 网络质量级别

枚举值

描述

HRTC_NETWORK_LEVEL_1

网络质量级别1级。

HRTC_NETWORK_LEVEL_2

网络质量级别2级。

HRTC_NETWORK_LEVEL_3

网络质量级别3级。

HRTC_NETWORK_LEVEL_4

网络质量级别4级。

HRTCNetworkTestState

表36 网络探测结果状态

枚举值

描述

HRTC_NETWORK_TEST_OK

探测成功。

HRTC_NETWORK_TEST_FAIL

探测失败。

HRTCNetworkTestResultParam

表37 网络探测结果参数

属性

类型

描述

bitRate

int

探测的带宽。

packetLoss

int

探测的丢包。

delay

int

探测的时延。

jitter

int

探测的抖动。

HRTCMediaDirection

表38 媒体方向指示

枚举值

描述

HRTC_MEDIA_LOCAL

本地媒体流。

HRTC_MEDIA_REMOTE

远端媒体流。

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!非常感谢您的反馈,我们会继续努力做到更好!
反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问