AVDRoom Class Reference

Inherits from NSObject
Declared in AVDRoom.h
AVDRoom.mm

Overview

房间接口类

房间接口定义了房间对象创建和释放、房间功能操作。

  userManager

< 房间逻辑回调代理

@property (nonatomic, strong) AVDUserManager *userManager

Discussion

< 房间逻辑回调代理

Declared In

AVDRoom.h

+ obtain:

获取房间对象

+ (AVDRoom *)obtain:(AVDRoomId)roomID

Return Value

返回房间对象指针。

Discussion

获取房间对象

Note: 房间对象的生命周期由AVD SDK来管理,应用层通过obtain获取一个房间对象,房间最终不使用的时候调用destory来释放。

Declared In

AVDRoom.h

– destory

释放房间对象

- (void)destory

Discussion

释放房间对象

Declared In

AVDRoom.h

– joinWithUser:delegate:

当前用户加入房间

- (AVDResult)joinWithUser:(AVDUser *)user delegate:(id<AVDRoomJoinDelegate>)joinresult

Return Value

返回错误代码。

Discussion

当前用户加入房间

@param[in] user 用户信息:用户Id,用户名,用户数据等;当应用层必须传入有效的user.UserId,来唯一标识一个用户。 @param[in] password 密码:如果是主持人请用主持人密码;如果是其他参会者,请用房间密码。 @param[in] joinresult 加房间回调接口。

Declared In

AVDRoom.h

– leave:

当前用户离开房间

- (AVDResult)leave:(AVDResult)reason

Return Value

返回错误代码。

Discussion

当前用户离开房间

@param[in] reason 用户离开房间的原因代码,正常离开为AVD_OK。

Note: 当前用户离开房间后,当前房间对象和房间的各功能模块都处于离会状态,功能操作无效。

Declared In

AVDRoom.h

– reJoin

重新加入当前房间

- (AVDResult)reJoin

Return Value

返回错误代码。

Discussion

重新加入当前房间

Note: 当用户主动离开房间或者中间网络断线后离开房间后,可以重新调用此函数加入房间。

Declared In

AVDRoom.h

– kickoutUser:userId:

房间中踢出用户

- (AVDResult)kickoutUser:(AVDResult)reason userId:(AVDUserId)userId

Return Value

返回错误代码。

Discussion

房间中踢出用户

@param[in] reason 踢出用户的理由代码。 @param[in] userId 被踢出用户Id。

Note: 被踢用户将会在onLeaveIndication中接收到回调,被踢用户直接调用 leave 离开房间即可。

Declared In

AVDRoom.h

– updateRoomStatus:

更新房间状态

- (AVDResult)updateRoomStatus:(enum AVDRoomStatus)status

Return Value

返回错误代码。

Discussion

更新房间状态

@param[in] status 房间状态。

Declared In

AVDRoom.h

– getRoomStatus

获取房间状态

- (enum AVDRoomStatus)getRoomStatus

Return Value

返回房间状态。

Discussion

获取房间状态

Declared In

AVDRoom.h

– getRoomId

获取房间Id

- (AVDRoomId)getRoomId

Return Value

返回房间Id。

Discussion

获取房间Id

Declared In

AVDRoom.h

– getAppRoomId

获取房间应用层Id

- (NSString *)getAppRoomId

Return Value

返回房间应用层Id。

Discussion

获取房间应用层Id

Note: 房间应用层Id在应用层安排当前房间的时候由应用层来指定,方便应用层查找、标示房间。

Declared In

AVDRoom.h

– getRoomName

获取房间名

- (NSString *)getRoomName

Return Value

返回房间名。

Discussion

获取房间名

Declared In

AVDRoom.h

– getRoomTopic

获取房间主题

- (NSString *)getRoomTopic

Return Value

返回房间主题。

Discussion

获取房间主题

Declared In

AVDRoom.h

– getRoomInfo

获取房间信息

- (AVDRoomInfo *)getRoomInfo

Return Value

返回房间信息。

Discussion

获取房间信息

Declared In

AVDRoom.h

– sendPublicData:

透明通道,发送广播数据

- (AVDResult)sendPublicData:(NSData *)data

Return Value

返回错误代码。

Discussion

透明通道,发送广播数据

@param[in] *data 发送的数据指针。

Note: 此透明通道用于承载应用层数据,广播给所有房间内用户。

Declared In

AVDRoom.h

– sendPrivateData:toUserId:

透明通道,发送私有数据

- (AVDResult)sendPrivateData:(NSData *)data toUserId:(AVDUserId)toId

Return Value

返回错误代码。

Discussion

透明通道,发送私有数据

@param[in] *data 发送的数据指针。 @param[in] toId 目的用户Id。

Note: 此透明通道用于承载应用层数据,发送给房间内某一特定用户。

Declared In

AVDRoom.h

– getAppData:

返回应用层的房间数据

- (NSString *)getAppData:(NSString *)key

Return Value

返回应用层的相应关键字的房间数据。

Discussion

返回应用层的房间数据

@param[in] *key 房间数据关键字。

Note: 应用层的房间数据方便应用层在房间中保留关于房间的一些业务逻辑数据,可以获取和修改应用层的房间数据。

Declared In

AVDRoom.h

– updateAppData:value:

修改应用层的房间数据

- (AVDResult)updateAppData:(NSString *)key value:(NSString *)value

Return Value

返回错误代码。

Discussion

修改应用层的房间数据

@param[in] key 房间数据关键字。 @param[in] value 房间数据对应关键字的信息内容

Declared In

AVDRoom.h

– enableStats:

当前房间启用或关闭流量统计功能 @param[in] isEnable 启用或关闭。

- (AVDResult)enableStats:(BOOL)isEnable

Return Value

返回错误代码: AVD_OK 成功

Discussion

当前房间启用或关闭流量统计功能 @param[in] isEnable 启用或关闭。

Declared In

AVDRoom.h

– getRoomStats

获取房间的流量统计信息

- (AVDRoomStats *)getRoomStats

Return Value

返回房间流量统计信息。

Discussion

获取房间的流量统计信息

Declared In

AVDRoom.h

– getMediaStats:

获取某路媒体(音频或者视频)的流量统计信息 @param[in] deviceId 设备Id。

- (AVDMediaStats *)getMediaStats:(AVDDeviceId)deviceId

Return Value

返回媒体统计信息。

Discussion

获取某路媒体(音频或者视频)的流量统计信息 @param[in] deviceId 设备Id。

Declared In

AVDRoom.h

– setOption:value:

设置房间选项

- (AVDResult)setOption:(enum AVDRoomOption)type value:(NSString *)svalue

Return Value

返回错误代码。

Discussion

设置房间选项

@param[in] type 房间选项类型。 @param[in] svalue 房间选项值。

Declared In

AVDRoom.h

– getOption:

获取房间选项

- (NSString *)getOption:(enum AVDRoomOption)type

Return Value

返回房间选项值。

Discussion

获取房间选项

@param[in] type 房间选项类型。

Declared In

AVDRoom.h