com.tencent.av.sdk
Class AVRoom

java.lang.Object
  com.tencent.av.sdk.AVRoom

Direct Known Subclasses:

AVRoomMulti

public class AVRoom
extends java.lang.Object

AVRoom表示一次音视频会话，所有房间的抽象类。
SDK致力于提供更良好的音视频体验，因此在不同场景下采用特定的策略进行优化:

• 当房间只有两个人时，无须服务器中转，建立直连即可可完成音视频通话。
• 当房间人数大于两个人时，情况就会变得相对复杂。
• 当房间人数大于1000时，服务器的架构也会变得复杂。

目前，SDK对应不同的用户场景，设计了双人、多人两类房间。
推荐您在创建房间前，对照用户场景和需求选择合适的房间类型，以保证更好的通话质量。
AVRoom作为所有房间的基类，提供最基本的接口，包括房间自身状态通知、房间信息查询。

Nested Class Summary

static interface	AVRoom.Delegate 房间最基本的委托类。
static class	AVRoom.EnterRoomParam 进入房间所需的参数基类。 通过AVContext.enterRoom方法进房间时使用。 app根据进房间类型，传入对应子类类型
static class	AVRoom.Info 房间配置信息。 room_id和relation_id并不是等价的，room_id是在房间创建成功后由服务器动态生成。 您可以认为relation_id是一次多人会话的标识。 假设A先创建一个多人房间，不退出房间，B使用和A相同的relation_id的创建房间，最终会进入同一个房间。 换句话说，同一个多人房间的有效生命周期内，relation_id会对应同一个room_id。 当创建双人房间时，Info初始化示例如下：

Field Summary

static int	AUDIO_CATEGORY_MEDIA_PLAY_AND_RECORD 媒体采集与播放模式。适合于那些对音质要求比较高的直播场景，如主播场景中的主播人员
static int	AUDIO_CATEGORY_MEDIA_PLAYBACK 媒体播放模式。适合于那些对音质要求比较高的直播场景，如主播场景中的听众
static int	AUDIO_CATEGORY_VOICECHAT 音视场景策略, VoIP模式。适合于实时音频通信场景，如实时语音通话
static long	AUTH_BITS_CREATE_ROOM 权限位, 创建房间权限
static long	AUTH_BITS_DEFUALT 权限位, 缺省值。拥有所有权限
static long	AUTH_BITS_JOIN_ROOM 权限位, 加入房间的权限
static long	AUTH_BITS_RECV_AUDIO 权限位, 接收语音的权限
static long	AUTH_BITS_RECV_SUB 权限位, 接收辅路视频的权限。暂不支持辅路
static long	AUTH_BITS_RECV_VIDEO 权限位, 接收视频的权限
static long	AUTH_BITS_SEND_AUDIO 权限位, 发送语音的权限
static long	AUTH_BITS_SEND_SUB 权限位, 发送辅路视频的权限。暂不支持辅路
static long	AUTH_BITS_SEND_VIDEO 权限位, 发送视频的权限
static int	AV_MODE_AUDIO 音视频通话模式, 纯语音通话，不能视频通话
static int	AV_MODE_VIDEO 音视频通话模式, 纯语音通话，可以进行视频通话
static int	AV_ROOM_MULTI 房间类型, 多人房间
static int	AV_ROOM_NONE 房间类型, 初始值，没有意义
static int	AV_ROOM_PAIR 房间类型, 双人房间
protected int	nativeObj

Constructor Summary

AVRoom()
构造函数

Method Summary

java.lang.String	getQualityTips() 获取房间QualityTips。 同步返回结果。
long	getRoomId() 获取房间id。 同步返回结果。
AVRoom.Info	getRoomInfo() 获取房间配置信息。 同步返回结果。
int	getRoomType() 获取房间类型。 同步返回结果。

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

nativeObj

protected int nativeObj

AV_ROOM_NONE

public static final int AV_ROOM_NONE

房间类型, 初始值，没有意义

See Also:

Constant Field Values

AV_ROOM_PAIR

public static final int AV_ROOM_PAIR

房间类型, 双人房间

See Also:

Constant Field Values

AV_ROOM_MULTI

public static final int AV_ROOM_MULTI

房间类型, 多人房间

See Also:

Constant Field Values

AV_MODE_AUDIO

public static final int AV_MODE_AUDIO

音视频通话模式, 纯语音通话，不能视频通话

See Also:

Constant Field Values

AV_MODE_VIDEO

public static final int AV_MODE_VIDEO

音视频通话模式, 纯语音通话，可以进行视频通话

See Also:

Constant Field Values

AUTH_BITS_DEFUALT

public static final long AUTH_BITS_DEFUALT

权限位, 缺省值。拥有所有权限

See Also:

Constant Field Values

AUTH_BITS_CREATE_ROOM

public static final long AUTH_BITS_CREATE_ROOM

权限位, 创建房间权限

See Also:

Constant Field Values

AUTH_BITS_JOIN_ROOM

public static final long AUTH_BITS_JOIN_ROOM

权限位, 加入房间的权限

See Also:

Constant Field Values

AUTH_BITS_SEND_AUDIO

public static final long AUTH_BITS_SEND_AUDIO

权限位, 发送语音的权限

See Also:

Constant Field Values

AUTH_BITS_RECV_AUDIO

public static final long AUTH_BITS_RECV_AUDIO

权限位, 接收语音的权限

See Also:

Constant Field Values

AUTH_BITS_SEND_VIDEO

public static final long AUTH_BITS_SEND_VIDEO

权限位, 发送视频的权限

See Also:

Constant Field Values

AUTH_BITS_RECV_VIDEO

public static final long AUTH_BITS_RECV_VIDEO

权限位, 接收视频的权限

See Also:

Constant Field Values

AUTH_BITS_SEND_SUB

public static final long AUTH_BITS_SEND_SUB

权限位, 发送辅路视频的权限。暂不支持辅路

See Also:

Constant Field Values

AUTH_BITS_RECV_SUB

public static final long AUTH_BITS_RECV_SUB

权限位, 接收辅路视频的权限。暂不支持辅路

See Also:

Constant Field Values

AUDIO_CATEGORY_VOICECHAT

public static final int AUDIO_CATEGORY_VOICECHAT

音视场景策略, VoIP模式。适合于实时音频通信场景，如实时语音通话

See Also:

Constant Field Values

AUDIO_CATEGORY_MEDIA_PLAY_AND_RECORD

public static final int AUDIO_CATEGORY_MEDIA_PLAY_AND_RECORD

媒体采集与播放模式。适合于那些对音质要求比较高的直播场景，如主播场景中的主播人员

See Also:

Constant Field Values

AUDIO_CATEGORY_MEDIA_PLAYBACK

public static final int AUDIO_CATEGORY_MEDIA_PLAYBACK

媒体播放模式。适合于那些对音质要求比较高的直播场景，如主播场景中的听众

See Also:

Constant Field Values

Constructor Detail

AVRoom

public AVRoom()

构造函数

Method Detail

getRoomInfo

public AVRoom.Info getRoomInfo()

获取房间配置信息。
同步返回结果。

Returns:

房间配置信息，创建房间之后，原先没有填写的room_id会同步。

getRoomId

public long getRoomId()

获取房间id。
同步返回结果。

Returns:

房间id。

getRoomType

public int getRoomType()

获取房间类型。
同步返回结果。

Returns:

房间id类型，取值如下：

• AV_ROOM_NONE 缺省房间。
• AV_ROOM_PAIR 双人房间。
• AV_ROOM_MULTI 多人房间。

getQualityTips

public java.lang.String getQualityTips()

获取房间QualityTips。
同步返回结果。

Returns:

QualityTips String类型：