nim_chatroom.h 文件参考

聊天室 接口头文件，在需要使用聊天室 SDK 的地方包含该头文件即可 更多...

#include "nim_chatroom_def.h"
#include "public_defines.h"

浏览源代码.

函数
NIM_SDK_DLL_API void	nim_chatroom_reg_enter_cb (const char *json_extension, nim_chatroom_enter_cb_func cb, const void *user_data)
	注册全局进入聊天室的回调
NIM_SDK_DLL_API void	nim_chatroom_reg_exit_cb (const char *json_extension, nim_chatroom_exit_cb_func cb, const void *user_data)
	注册全局登出、被踢回调
NIM_SDK_DLL_API void	nim_chatroom_reg_link_condition_cb (const char *json_extension, nim_chatroom_link_condition_cb_func cb, const void *user_data)
	注册聊天室链接状况回调
NIM_SDK_DLL_API void	nim_chatroom_reg_send_msg_ack_cb (const char *json_extension, nim_chatroom_sendmsg_arc_cb_func cb, const void *user_data)
	注册全局发送消息回执回调
NIM_SDK_DLL_API void	nim_chatroom_reg_receive_msg_cb (const char *json_extension, nim_chatroom_receive_msg_cb_func cb, const void *user_data)
	注册全局接收消息回调
NIM_SDK_DLL_API void	nim_chatroom_reg_receive_msgs_cb (const char *json_extension, nim_chatroom_receive_msg_cb_func cb, const void *user_data)
	注册全局接收批量消息回调
NIM_SDK_DLL_API void	nim_chatroom_reg_receive_notification_cb (const char *json_extension, nim_chatroom_receive_notification_cb_func cb, const void *user_data)
	注册全局接收通知回调
NIM_SDK_DLL_API void	nim_chatroom_reg_custom_token_cb (const char *json_extension, nim_chatroom_custom_token_cb_func cb, const void *user_data)
NIM_SDK_DLL_API void	nim_chatroom_reg_request_login_token_cb (const char *json_extension, nim_chatroom_request_login_token_cb_func cb, const void *user_data)
NIM_SDK_DLL_API void	nim_chatroom_reg_request_login_extension_cb (const char *json_extension, nim_chatroom_request_login_extension_cb_func cb, const void *user_data)
NIM_SDK_DLL_API void	nim_chatroom_reg_tags_changed_cb (const char *json_extension, nim_chatroom_tags_changed_cb_func cb, const void *user_data)
NIM_SDK_DLL_API void	nim_chatroom_reg_sdk_log_cb (nim_chatroom_sdk_log_cb_func cb, const void *user_data)
NIM_SDK_DLL_API void	nim_chatroom_init (const char *json_extension)
	聊天室模块初始化(SDK初始化时调用一次)
NIM_SDK_DLL_API void	nim_chatroom_cleanup (const char *json_extension)
	聊天室模块清理(SDK卸载前调用一次)
NIM_SDK_DLL_API bool	nim_chatroom_enter_with_anoymity (const int64_t room_id, const char *anonymity_info, const char *enter_info, const char *json_extension)
	聊天室匿名进入
NIM_SDK_DLL_API bool	nim_chatroom_enter_with_anoymity2 (const int64_t room_id, const char *anonymity_info, const char *enter_info, const NIMChatRoomConfigGetter config_getter)
	聊天室匿名进入
NIM_SDK_DLL_API bool	nim_chatroom_independent_enter (const int64_t room_id, const char *enter_info)
	独立进入聊天室
NIM_SDK_DLL_API bool	nim_chatroom_independent_enter2 (const int64_t room_id, const char *enter_info, const NIMChatRoomConfigGetter config_getter)
	独立进入聊天室
NIM_SDK_DLL_API bool	nim_chatroom_enter (const int64_t room_id, const char *request_enter_data, const char *enter_info, const char *json_extension)
	聊天室进入
NIM_SDK_DLL_API void	nim_chatroom_exit (const int64_t room_id, const char *json_extension)
	聊天室登出
NIM_SDK_DLL_API void	nim_chatroom_set_msgs_batch_report (bool set_batch, const char *json_extension)
	设置消息接收批量上报开关
NIM_SDK_DLL_API int	nim_chatroom_get_login_state (const int64_t room_id, const char *json_extension)
	获取登录状态
NIM_SDK_DLL_API void	nim_chatroom_send_msg (const int64_t room_id, const char *msg, const char *json_extension)
	发送消息
NIM_SDK_DLL_API void	nim_chatroom_get_members_online_async (const int64_t room_id, const char *parameters_json_str, const char *json_extension, nim_chatroom_get_members_cb_func cb, const void *user_data)
	异步获取聊天室成员信息
NIM_SDK_DLL_API void	nim_chatroom_get_members_by_tag_online_async (const int64_t room_id, const char *parameters_json_str, const char *json_extension, nim_chatroom_get_members_cb_func cb, const void *user_data)
	根据 tag 分页获取聊天室成员列表
NIM_SDK_DLL_API void	nim_chatroom_get_msg_history_online_async (const int64_t room_id, const char *parameters_json_str, const char *json_extension, nim_chatroom_get_msg_cb_func cb, const void *user_data)
	异步获取消息历史
NIM_SDK_DLL_API void	nim_chatroom_get_msg_history_by_tags_online_async (const int64_t room_id, const char *parameters_json_str, const char *json_extension, nim_chatroom_get_msg_cb_func cb, const void *user_data)
	根据发送消息时绑定的标签查询历史消息
NIM_SDK_DLL_API void	nim_chatroom_set_member_attribute_async (const int64_t room_id, const char *notify_ext, const char *json_extension, nim_chatroom_set_member_attribute_cb_func cb, const void *user_data)
	异步修改成员身份标识
NIM_SDK_DLL_API void	nim_chatroom_get_info_async (const int64_t room_id, const char *json_extension, nim_chatroom_get_info_cb_func cb, const void *user_data)
	异步获取当前聊天室信息
NIM_SDK_DLL_API void	nim_chatroom_get_members_by_ids_online_async (const int64_t room_id, const char *ids_json_array_string, const char *json_extension, nim_chatroom_get_members_cb_func cb, const void *user_data)
	异步获取指定成员信息
NIM_SDK_DLL_API void	nim_chatroom_kick_member_async (const int64_t room_id, const char *id, const char *notify_ext, const char *json_extension, nim_chatroom_kick_member_cb_func cb, const void *user_data)
	异步踢掉指定成员
NIM_SDK_DLL_API void	nim_chatroom_set_proxy (enum NIMChatRoomProxyType type, const char *host, int port, const char *user, const char *password)
	设置Chatroom SDK统一的网络代理。不需要代理时，type设置为kNIMProxyNone，其余参数都传空字符串（端口设为0）。有些代理不需要用户名和密码，相应参数也传空字符串。
NIM_SDK_DLL_API void	nim_chatroom_temp_mute_member_async (const int64_t room_id, const char *accid, const int64_t duration, bool need_notify, const char *notify_ext, const char *json_extension, nim_chatroom_temp_mute_member_cb_func cb, const void *user_data)
	异步临时禁言/解禁成员
NIM_SDK_DLL_API void	nim_chatroom_temp_mute_member_by_tag_async (const int64_t room_id, const char *target_tag, const int64_t duration, bool need_notify, const char *notify_ext, const char *notify_tags, const char *json_extension, nim_chatroom_temp_mute_member_cb_func cb, const void *user_data)
	异步禁言指定 tag 成员
NIM_SDK_DLL_API void	nim_chatroom_query_members_count_by_tag_async (const int64_t room_id, const char *target_tag, const char *json_extension, nim_chatroom_query_members_count_by_tag_cb_func cb, const void *user_data)
	查询指定 tag 在聊天室的成员数量
NIM_SDK_DLL_API void	nim_chatroom_update_room_info_async (const int64_t room_id, const char *room_info_json_str, bool need_notify, const char *notify_ext, const char *json_extension, nim_chatroom_update_room_info_cb_func cb, const void *user_data)
	更新聊天室信息，目前只支持更新 kNIMChatRoomInfoKeyName, kNIMChatRoomInfoKeyAnnouncement, kNIMChatRoomInfoKeyBroadcastUrl, kNIMChatRoomInfoKeyExt, kNIMChatRoomInfoKeyQueuelevel 五个字段
NIM_SDK_DLL_API void	nim_chatroom_update_my_role_async (const int64_t room_id, const char *role_info_json_str, bool need_notify, const char *notify_ext, const char *json_extension, nim_chatroom_update_my_role_cb_func cb, const void *user_data)
	更新我的信息，目前只支持更新kNIMChatRoomMemberInfoKeyNick,kNIMChatRoomMemberInfoKeyAvatar,kNIMChatRoomMemberInfoKeyExt三个字段
NIM_SDK_DLL_API void	nim_chatroom_queue_offer_async (const int64_t room_id, const char *element_key, const char *element_value, const char *json_extension, nim_chatroom_queue_offer_cb_func cb, const void *user_data)
	新加(更新)麦序队列元素,如果element_key对应的元素已经在队列中存在了，那就是更新操作，如果不存在，就放到队列尾部
NIM_SDK_DLL_API void	nim_chatroom_queue_poll_async (const int64_t room_id, const char *element_key, const char *json_extension, nim_chatroom_queue_poll_cb_func cb, const void *user_data)
	取出麦序头元素
NIM_SDK_DLL_API void	nim_chatroom_queue_list_async (const int64_t room_id, const char *json_extension, nim_chatroom_queue_list_cb_func cb, const void *user_data)
	排序列出所有麦序元素
NIM_SDK_DLL_API void	nim_chatroom_queue_header_async (const int64_t room_id, const char *json_extension, nim_chatroom_queue_header_cb_func cb, const void *user_data)
	查看麦序头元素
NIM_SDK_DLL_API void	nim_chatroom_queue_drop_async (const int64_t room_id, const char *json_extension, nim_chatroom_queue_drop_cb_func cb, const void *user_data)
	(聊天室管理员权限)删除麦序队列
NIM_SDK_DLL_API void	nim_chatroom_get_robots_async (const int64_t room_id, int64_t timetag, const char *json_extension, nim_chatroom_query_robots_cb_func cb, const void *user_data)
	获取全部机器人信息
NIM_SDK_DLL_API const char *	nim_chatroom_query_all_robots_block (const int64_t room_id, const char *json_extension)
	获取全部机器人信息(同步接口，堵塞NIM内部线程)
NIM_SDK_DLL_API char *	nim_chatroom_query_robot_by_accid_block (const int64_t room_id, const char *accid, const char *json_extension)
	获取指定机器人信息(同步接口，堵塞NIM内部线程)
NIM_SDK_DLL_API void	nim_chatroom_batch_upate_async (const int64_t room_id, const char *element_info_json_str, bool need_notify, const char *notify_ext, const char *json_extension, nim_chatroom_batch_update_cb cb, const void *user_data)
	批量更新队列信息
NIM_SDK_DLL_API void	nim_chatroom_update_location_async (const int64_t room_id, NIMChatRoomLocation location, nim_chatroom_update_location_cb_func cb, const char *json_extension, const void *user_data)
	更新聊天室当前用户的位置信息，一般配合游戏业务使用
NIM_SDK_DLL_API void	nim_chatroom_update_tags_async (const int64_t room_id, NIMChatRoomUpdateTagsInfo tags_info, nim_chatroom_update_tags_cb_func cb, const char *json_extension, const void *user_data)
	更新聊天室标签

详细描述

聊天室 接口头文件，在需要使用聊天室 SDK 的地方包含该头文件即可

版权所有

(c) 2015-2024, NetEase Inc. All rights reserved

作者

Oleg, Harrison

日期

2015/12/28

函数说明

nim_chatroom_batch_upate_async()

void nim_chatroom_batch_upate_async	(	const int64_t	room_id,
		const char *	element_info_json_str,
		bool	need_notify,
		const char *	notify_ext,
		const char *	json_extension,
		nim_chatroom_batch_update_cb	cb,
		const void *	user_data
	)

批量更新队列信息

参数

[in]	room_id	聊天室ID
[in]	element_info_json_str	批量更新元素
[in]	need_notify	是否聊天室内广播通知
[in]	notify_ext	通知中的自定义字段，长度限制2048
[in]	json_extension	json扩展参数（备用，目前不需要）
[in]	cb	回调函数, 定义见nim_chatroom_def.h
[in]	user_data	APP的自定义用户数据，SDK只负责传回给回调函数cb，不做任何处理！

返回

void 无返回值

nim_chatroom_cleanup()

void nim_chatroom_cleanup

(

const char *

json_extension

)

聊天室模块清理(SDK卸载前调用一次)

参数

[in]

json_extension

json扩展参数（备用，目前不需要）

返回

void 无返回值

nim_chatroom_enter()

bool nim_chatroom_enter	(	const int64_t	room_id,
		const char *	request_enter_data,
		const char *	enter_info,
		const char *	json_extension
	)

聊天室进入

参数

[in]	room_id	聊天室ID
[in]	request_enter_data	聊天室进入信息(NIM SDK请求聊天室返回的数据)
[in]	enter_info	聊天室可选信息
[in]	json_extension	json扩展参数（备用，目前不需要）

返回

bool 进入信息是否正确,返回失败则不会触发进入回调

nim_chatroom_enter_with_anoymity()

bool nim_chatroom_enter_with_anoymity	(	const int64_t	room_id,
		const char *	anonymity_info,
		const char *	enter_info,
		const char *	json_extension
	)

聊天室匿名进入

参数

[in]	room_id	聊天室ID
[in]	anonymity_info	匿名登录所需的信息
[in]	enter_info	聊天室进入信息
[in]	json_extension	json扩展参数（备用，目前不需要）

返回

bool 进入信息是否正确,返回失败则不会触发进入回调

nim_chatroom_enter_with_anoymity2()

bool nim_chatroom_enter_with_anoymity2	(	const int64_t	room_id,
		const char *	anonymity_info,
		const char *	enter_info,
		const NIMChatRoomConfigGetter	config_getter
	)

聊天室匿名进入

参数

[in]	room_id	聊天室ID
[in]	anonymity_info	匿名登录所需的信息
[in]	enter_info	聊天室进入信息
[in]	config_getter	配置参数获取对象

返回

bool 进入信息是否正确,返回失败则不会触发进入回调

nim_chatroom_exit()

void nim_chatroom_exit	(	const int64_t	room_id,
		const char *	json_extension
	)

聊天室登出

参数

[in]	room_id	聊天室ID
[in]	json_extension	json扩展参数（备用，目前不需要）

返回

void 无返回值

nim_chatroom_get_info_async()

void nim_chatroom_get_info_async	(	const int64_t	room_id,
		const char *	json_extension,
		nim_chatroom_get_info_cb_func	cb,
		const void *	user_data
	)

异步获取当前聊天室信息

参数

[in]	room_id	聊天室ID
[in]	json_extension	json扩展参数（备用，目前不需要）
[in]	cb	回调函数, 定义见nim_chatroom_def.h
[in]	user_data	APP的自定义用户数据，SDK只负责传回给回调函数cb，不做任何处理！

返回

void 无返回值

nim_chatroom_get_login_state()

int nim_chatroom_get_login_state	(	const int64_t	room_id,
		const char *	json_extension
	)

获取登录状态

参数

[in]	room_id	聊天室ID
[in]	json_extension	json扩展参数（备用，目前不需要）

返回

int 登录状态

nim_chatroom_get_members_by_ids_online_async()

void nim_chatroom_get_members_by_ids_online_async	(	const int64_t	room_id,
		const char *	ids_json_array_string,
		const char *	json_extension,
		nim_chatroom_get_members_cb_func	cb,
		const void *	user_data
	)

异步获取指定成员信息

参数

[in]	room_id	聊天室ID
[in]	ids_json_array_string	json array string
[in]	json_extension	json扩展参数（备用，目前不需要）
[in]	cb	回调函数, 定义见nim_chatroom_def.h
[in]	user_data	APP的自定义用户数据，SDK只负责传回给回调函数cb，不做任何处理！

返回

void 无返回值

注解

错误码 200:成功 414:参数错误

nim_chatroom_get_members_by_tag_online_async()

void nim_chatroom_get_members_by_tag_online_async	(	const int64_t	room_id,
		const char *	parameters_json_str,
		const char *	json_extension,
		nim_chatroom_get_members_cb_func	cb,
		const void *	user_data
	)

根据 tag 分页获取聊天室成员列表

参数

room_id	聊天室ID
parameters_json_str	参数json string
json_extension	json扩展参数（备用，目前不需要）
cb	回调函数, 定义见nim_chatroom_def.h
user_data	APP的自定义用户数据，SDK只负责传回给回调函数cb，不做任何处理！

返回

void 无返回值

nim_chatroom_get_members_online_async()

void nim_chatroom_get_members_online_async	(	const int64_t	room_id,
		const char *	parameters_json_str,
		const char *	json_extension,
		nim_chatroom_get_members_cb_func	cb,
		const void *	user_data
	)

异步获取聊天室成员信息

参数

[in]	room_id	聊天室ID
[in]	parameters_json_str	参数json string
[in]	json_extension	json扩展参数（备用，目前不需要）
[in]	cb	回调函数, 定义见nim_chatroom_def.h
[in]	user_data	APP的自定义用户数据，SDK只负责传回给回调函数cb，不做任何处理！

返回

void 无返回值

nim_chatroom_get_msg_history_by_tags_online_async()

NIM_SDK_DLL_API void nim_chatroom_get_msg_history_by_tags_online_async	(	const int64_t	room_id,
		const char *	parameters_json_str,
		const char *	json_extension,
		nim_chatroom_get_msg_cb_func	cb,
		const void *	user_data
	)

根据发送消息时绑定的标签查询历史消息

参数

room_id	聊天室 ID
parameters_json_str	查询参数格式 {"tags":["abc","bcd","def"],"limit":10,"start":0,"end":1665542603510,"reverse":false,"message_types":[0,1,2,3,4,5,6]}
json_extension	json 扩展参数（备用，目前不需要）
cb	回调函数, 定义见nim_chatroom_def.h
user_data	APP 的自定义用户数据，SDK 只负责传回给回调函数 cb，不做任何处理！

返回

void 无返回值

nim_chatroom_get_msg_history_online_async()

void nim_chatroom_get_msg_history_online_async	(	const int64_t	room_id,
		const char *	parameters_json_str,
		const char *	json_extension,
		nim_chatroom_get_msg_cb_func	cb,
		const void *	user_data
	)

异步获取消息历史

参数

[in]	room_id	聊天室ID
[in]	parameters_json_str	参数json string
[in]	json_extension	json扩展参数（备用，目前不需要）
[in]	cb	回调函数, 定义见nim_chatroom_def.h
[in]	user_data	APP的自定义用户数据，SDK只负责传回给回调函数cb，不做任何处理！

返回

void 无返回值

nim_chatroom_get_robots_async()

void nim_chatroom_get_robots_async	(	const int64_t	room_id,
		int64_t	timetag,
		const char *	json_extension,
		nim_chatroom_query_robots_cb_func	cb,
		const void *	user_data
	)

获取全部机器人信息

参数

[in]	room_id	聊天室ID
[in]	timetag	时间戳
[in]	json_extension	json扩展参数（备用，目前不需要）
[in]	cb	回调函数 回调函数定义见nim_robot_def.h
[in]	user_data	APP的自定义用户数据，SDK只负责传回给回调函数cb，不做任何处理！

返回

void

nim_chatroom_independent_enter()

bool nim_chatroom_independent_enter	(	const int64_t	room_id,
		const char *	enter_info
	)

独立进入聊天室

参数

[in]	room_id	聊天室ID
[in]	enter_info	聊天室进入信息

返回

bool 进入信息是否正确,返回失败则不会触发进入回调

nim_chatroom_independent_enter2()

bool nim_chatroom_independent_enter2	(	const int64_t	room_id,
		const char *	enter_info,
		const NIMChatRoomConfigGetter	config_getter
	)

独立进入聊天室

参数

[in]	room_id	聊天室ID
[in]	enter_info	聊天室进入信息
[in]	config_getter	配置参数获取对象

返回

bool 进入信息是否正确,返回失败则不会触发进入回调

nim_chatroom_init()

void nim_chatroom_init

(

const char *

json_extension

)

聊天室模块初始化(SDK初始化时调用一次)

参数

[in]

json_extension

json扩展参数（备用，目前不需要）

返回

void

nim_chatroom_kick_member_async()

void nim_chatroom_kick_member_async	(	const int64_t	room_id,
		const char *	id,
		const char *	notify_ext,
		const char *	json_extension,
		nim_chatroom_kick_member_cb_func	cb,
		const void *	user_data
	)

异步踢掉指定成员

参数

[in]	room_id	聊天室ID
[in]	id	成员id
[in]	notify_ext	放到事件通知中的扩展字段
[in]	json_extension	json扩展参数（备用，目前不需要）
[in]	cb	回调函数, 定义见nim_chatroom_def.h
[in]	user_data	APP的自定义用户数据，SDK只负责传回给回调函数cb，不做任何处理！

返回

void 无返回值

注解

错误码 200:成功 403:无权限 404:被踢账号无效或非在线

nim_chatroom_query_all_robots_block()

char * nim_chatroom_query_all_robots_block	(	const int64_t	room_id,
		const char *	json_extension
	)

获取全部机器人信息(同步接口，堵塞NIM内部线程)

参数

[in]	room_id	聊天室ID
[in]	json_extension	json扩展参数（备用，目前不需要）

返回

char 机器人信息 json string array

nim_chatroom_query_members_count_by_tag_async()

void nim_chatroom_query_members_count_by_tag_async	(	const int64_t	room_id,
		const char *	target_tag,
		const char *	json_extension,
		nim_chatroom_query_members_count_by_tag_cb_func	cb,
		const void *	user_data
	)

查询指定 tag 在聊天室的成员数量

参数

room_id	聊天室ID
target_tag	要查询的指定 tag
json_extension	json扩展参数（备用，目前不需要）
cb	回调函数, 定义见nim_chatroom_def.h
user_data	APP的自定义用户数据，SDK只负责传回给回调函数cb，不做任何处理！

返回

void 无返回值

nim_chatroom_query_robot_by_accid_block()

char * nim_chatroom_query_robot_by_accid_block	(	const int64_t	room_id,
		const char *	accid,
		const char *	json_extension
	)

获取指定机器人信息(同步接口，堵塞NIM内部线程)

参数

[in]	room_id	聊天室ID
[in]	accid	机器人accid
[in]	json_extension	json扩展参数（备用，目前不需要）

返回

char 机器人信息 json string

nim_chatroom_queue_drop_async()

void nim_chatroom_queue_drop_async	(	const int64_t	room_id,
		const char *	json_extension,
		nim_chatroom_queue_drop_cb_func	cb,
		const void *	user_data
	)

(聊天室管理员权限)删除麦序队列

参数

[in]	room_id	聊天室ID
[in]	json_extension	json扩展参数（备用，目前不需要）
[in]	cb	回调函数, 定义见nim_chatroom_def.h
[in]	user_data	APP的自定义用户数据，SDK只负责传回给回调函数cb，不做任何处理！

返回

void 无返回值

nim_chatroom_queue_header_async()

void nim_chatroom_queue_header_async	(	const int64_t	room_id,
		const char *	json_extension,
		nim_chatroom_queue_header_cb_func	cb,
		const void *	user_data
	)

查看麦序头元素

参数

[in]	room_id	聊天室ID
[in]	json_extension	json扩展参数（备用，目前不需要）
[in]	cb	回调函数, 定义见nim_chatroom_def.h
[in]	user_data	APP的自定义用户数据，SDK只负责传回给回调函数cb，不做任何处理！

返回

void 无返回值

nim_chatroom_queue_list_async()

void nim_chatroom_queue_list_async	(	const int64_t	room_id,
		const char *	json_extension,
		nim_chatroom_queue_list_cb_func	cb,
		const void *	user_data
	)

排序列出所有麦序元素

参数

[in]	room_id	聊天室ID
[in]	json_extension	json扩展参数（备用，目前不需要）
[in]	cb	回调函数, 定义见nim_chatroom_def.h
[in]	user_data	APP的自定义用户数据，SDK只负责传回给回调函数cb，不做任何处理！

返回

void 无返回值

nim_chatroom_queue_offer_async()

void nim_chatroom_queue_offer_async	(	const int64_t	room_id,
		const char *	element_key,
		const char *	element_value,
		const char *	json_extension,
		nim_chatroom_queue_offer_cb_func	cb,
		const void *	user_data
	)

新加(更新)麦序队列元素,如果element_key对应的元素已经在队列中存在了，那就是更新操作，如果不存在，就放到队列尾部

参数

[in]	room_id	聊天室ID
[in]	element_key	新元素的UniqKey,长度限制128字节
[in]	element_value	新元素内容，长度限制4096字节
[in]	json_extension	json扩展参数（备用，目前不需要）
[in]	cb	回调函数, 定义见nim_chatroom_def.h
[in]	user_data	APP的自定义用户数据，SDK只负责传回给回调函数cb，不做任何处理！

返回

void 无返回值

注解

错误码 200:成功 403:无权限,只有管理员能操作 414:参数错误

nim_chatroom_queue_poll_async()

void nim_chatroom_queue_poll_async	(	const int64_t	room_id,
		const char *	element_key,
		const char *	json_extension,
		nim_chatroom_queue_poll_cb_func	cb,
		const void *	user_data
	)

取出麦序头元素

参数

[in]	room_id	聊天室ID
[in]	element_key	需要取出的元素的UniqKey,长度限制128字节,传空传表示取出第一个元素
[in]	json_extension	json扩展参数（备用，目前不需要）
[in]	cb	回调函数, 定义见nim_chatroom_def.h
[in]	user_data	APP的自定义用户数据，SDK只负责传回给回调函数cb，不做任何处理！

返回

void 无返回值

注解

错误码 200:成功 403:无权限，只有管理员才能操作 404:没有元素可取出

nim_chatroom_reg_custom_token_cb()

void nim_chatroom_reg_custom_token_cb	(	const char *	json_extension,
		nim_chatroom_custom_token_cb_func	cb,
		const void *	user_data
	)

(全局回调) 注册全局聊天室自定义token获取回调

参数

[in]	json_extension	json扩展参数（备用，目前不需要）
[in]	cb	获取动态token回调
[in]	user_data	APP的自定义用户数据，SDK只负责传回给回调函数cb，不做任何处理！

返回

void 无返回值

注解

错误码 无

nim_chatroom_reg_enter_cb()

void nim_chatroom_reg_enter_cb	(	const char *	json_extension,
		nim_chatroom_enter_cb_func	cb,
		const void *	user_data
	)

注册全局进入聊天室的回调

参数

[in]	json_extension	json扩展参数（备用，目前不需要）
[in]	cb	回调函数, 定义见nim_chatroom_def.h
[in]	user_data	APP的自定义用户数据，SDK只负责传回给回调函数cb，不做任何处理！

返回

void 无返回值

注解

错误码 200:成功 414:参数错误 404:聊天室不存在 403:无权限 500:服务器内部错误 13001:IM主连接状态异常 13002:聊天室状态异常 13003:黑名单用户禁止进入聊天室

nim_chatroom_reg_exit_cb()

void nim_chatroom_reg_exit_cb	(	const char *	json_extension,
		nim_chatroom_exit_cb_func	cb,
		const void *	user_data
	)

注册全局登出、被踢回调

参数

[in]	json_extension	json扩展参数（备用，目前不需要）
[in]	cb	回调函数, 定义见nim_chatroom_def.h
[in]	user_data	APP的自定义用户数据，SDK只负责传回给回调函数cb，不做任何处理！

返回

void 无返回值

注解

错误码 200:成功

nim_chatroom_reg_link_condition_cb()

void nim_chatroom_reg_link_condition_cb	(	const char *	json_extension,
		nim_chatroom_link_condition_cb_func	cb,
		const void *	user_data
	)

注册聊天室链接状况回调

参数

[in]	json_extension	json扩展参数（备用，目前不需要）
[in]	cb	回调函数, 定义见nim_chatroom_def.h
[in]	user_data	APP的自定义用户数据，SDK只负责传回给回调函数cb，不做任何处理！

返回

void 无返回值

nim_chatroom_reg_receive_msg_cb()

void nim_chatroom_reg_receive_msg_cb	(	const char *	json_extension,
		nim_chatroom_receive_msg_cb_func	cb,
		const void *	user_data
	)

注册全局接收消息回调

参数

[in]	json_extension	json扩展参数（备用，目前不需要）
[in]	cb	回调函数, 定义见nim_chatroom_def.h
[in]	user_data	APP的自定义用户数据，SDK只负责传回给回调函数cb，不做任何处理！

返回

void 无返回值

nim_chatroom_reg_receive_msgs_cb()

void nim_chatroom_reg_receive_msgs_cb	(	const char *	json_extension,
		nim_chatroom_receive_msg_cb_func	cb,
		const void *	user_data
	)

注册全局接收批量消息回调

参数

[in]	json_extension	json扩展参数（备用，目前不需要）
[in]	cb	回调函数, 定义见nim_chatroom_def.h
[in]	user_data	APP的自定义用户数据，SDK只负责传回给回调函数cb，不做任何处理！

返回

void 无返回值

nim_chatroom_reg_receive_notification_cb()

void nim_chatroom_reg_receive_notification_cb	(	const char *	json_extension,
		nim_chatroom_receive_notification_cb_func	cb,
		const void *	user_data
	)

注册全局接收通知回调

参数

[in]	json_extension	json扩展参数（备用，目前不需要）
[in]	cb	回调函数, 定义见nim_chatroom_def.h
[in]	user_data	APP的自定义用户数据，SDK只负责传回给回调函数cb，不做任何处理！

返回

void 无返回值

nim_chatroom_reg_request_login_extension_cb()

void nim_chatroom_reg_request_login_extension_cb	(	const char *	json_extension,
		nim_chatroom_request_login_extension_cb_func	cb,
		const void *	user_data
	)

参数

[in]	json_extension	json扩展参数（备用，目前不需要）
[in]	cb	获取第三方鉴权扩展信息回调
[in]	user_data	APP的自定义用户数据，SDK只负责传回给回调函数cb，不做任何处理！

返回

void 无返回值

注解

错误码 无

nim_chatroom_reg_request_login_token_cb()

void nim_chatroom_reg_request_login_token_cb	(	const char *	json_extension,
		nim_chatroom_request_login_token_cb_func	cb,
		const void *	user_data
	)

(全局回调) 注册全局聊天室自定义token获取回调

参数

[in]	json_extension	json扩展参数（备用，目前不需要）
[in]	cb	获取动态token回调
[in]	user_data	APP的自定义用户数据，SDK只负责传回给回调函数cb，不做任何处理！

返回

void 无返回值

注解

错误码 无

nim_chatroom_reg_sdk_log_cb()

NIM_SDK_DLL_API void nim_chatroom_reg_sdk_log_cb	(	nim_chatroom_sdk_log_cb_func	cb,
		const void *	user_data
	)

nim_chatroom_reg_send_msg_ack_cb()

void nim_chatroom_reg_send_msg_ack_cb	(	const char *	json_extension,
		nim_chatroom_sendmsg_arc_cb_func	cb,
		const void *	user_data
	)

注册全局发送消息回执回调

参数

[in]	json_extension	json扩展参数（备用，目前不需要）
[in]	cb	回调函数, 定义见nim_chatroom_def.h
[in]	user_data	APP的自定义用户数据，SDK只负责传回给回调函数cb，不做任何处理！

返回

void 无返回值

注解

错误码 200:成功 414:参数错误 416:频率受限(目前配置5分钟300条) 13004:被禁言 13006:聊天室处于整体禁言状态,只有管理员能发言

nim_chatroom_reg_tags_changed_cb()

void nim_chatroom_reg_tags_changed_cb	(	const char *	json_extension,
		nim_chatroom_tags_changed_cb_func	cb,
		const void *	user_data
	)

(全局回调) 当自己的 tags 信息在聊天室被修改时通过该回调进行通知

参数

[in]	json_extension	json 扩展参数（备用，目前不需要）
[in]	cb	回调函数用于接收变更后的 tags 信息
[in]	user_data	APP 的自定义用户数据，SDK只负责传回给回调函数cb，不做任何处理！

返回

void 无返回值

nim_chatroom_send_msg()

void nim_chatroom_send_msg	(	const int64_t	room_id,
		const char *	msg,
		const char *	json_extension
	)

发送消息

参数

[in]	room_id	聊天室ID
[in]	msg	消息json string
[in]	json_extension	json扩展参数（备用，目前不需要）

返回

void 无返回值

nim_chatroom_set_member_attribute_async()

void nim_chatroom_set_member_attribute_async	(	const int64_t	room_id,
		const char *	notify_ext,
		const char *	json_extension,
		nim_chatroom_set_member_attribute_cb_func	cb,
		const void *	user_data
	)

异步修改成员身份标识

参数

[in]	room_id	聊天室ID
[in]	parameters_json_str	参数json string
[in]	json_extension	json扩展参数（备用，目前不需要）
[in]	cb	回调函数, 定义见nim_chatroom_def.h
[in]	user_data	APP的自定义用户数据，SDK只负责传回给回调函数cb，不做任何处理！

返回

void 无返回值

注解

错误码 200:成功 414:参数异常 417:重复操作 403:无权限 500:服务器错误 13002: 聊天室状态异常 13003:在黑名单中 13004:在禁言名单中

nim_chatroom_set_msgs_batch_report()

void nim_chatroom_set_msgs_batch_report	(	bool	set_batch,
		const char *	json_extension
	)

设置消息接收批量上报开关

参数

[in]	set_batch	批量开关
[in]	json_extension	json扩展参数（备用，目前不需要）

返回

void 无返回值

nim_chatroom_set_proxy()

void nim_chatroom_set_proxy	(	enum NIMChatRoomProxyType	type,
		const char *	host,
		int	port,
		const char *	user,
		const char *	password
	)

设置Chatroom SDK统一的网络代理。不需要代理时，type设置为kNIMProxyNone，其余参数都传空字符串（端口设为0）。有些代理不需要用户名和密码，相应参数也传空字符串。

参数

[in]	type	代理类型，见NIMProxyType定义
[in]	host	代理地址
[in]	port	代理端口
[in]	user	代理用户名
[in]	password	代理密码

返回

void 无返回值

nim_chatroom_temp_mute_member_async()

void nim_chatroom_temp_mute_member_async	(	const int64_t	room_id,
		const char *	accid,
		const int64_t	duration,
		bool	need_notify,
		const char *	notify_ext,
		const char *	json_extension,
		nim_chatroom_temp_mute_member_cb_func	cb,
		const void *	user_data
	)

异步临时禁言/解禁成员

参数

[in]	room_id	聊天室ID
[in]	accid	成员ID
[in]	duration	临时禁言时长（秒），解禁填0
[in]	need_notify	是否聊天室内广播通知
[in]	notify_ext	通知中的自定义字段，长度限制2048
[in]	json_extension	json扩展参数（备用，目前不需要）
[in]	cb	回调函数, 定义见nim_chatroom_def.h
[in]	user_data	APP的自定义用户数据，SDK只负责传回给回调函数cb，不做任何处理！

返回

void 无返回值

注解

错误码 200:成功 403:无权限操作，只有管理员可以操作，管理员只能被创建者操作，自己不能操作自己 414:参数错误 417:重复操作，如果已经是黑名单或永久禁言状态，不能设置为临时禁言状态

nim_chatroom_temp_mute_member_by_tag_async()

void nim_chatroom_temp_mute_member_by_tag_async	(	const int64_t	room_id,
		const char *	target_tag,
		const int64_t	duration,
		bool	need_notify,
		const char *	notify_ext,
		const char *	notify_tags,
		const char *	json_extension,
		nim_chatroom_temp_mute_member_cb_func	cb,
		const void *	user_data
	)

异步禁言指定 tag 成员

参数

room_id	聊天室ID
target_tag	要禁言的指定 tag
duration	临时禁言时长（秒），解禁填0
need_notify	是否聊天室内广播通知
notify_ext	通知中的自定义字段，长度限制2048
notify_tags	设置通知指定 tag 下的成员
json_extension	json扩展参数（备用，目前不需要）
cb	回调函数, 定义见nim_chatroom_def.h
user_data	APP的自定义用户数据，SDK只负责传回给回调函数cb，不做任何处理！

返回

void 无返回值

nim_chatroom_update_location_async()

NIM_SDK_DLL_API void nim_chatroom_update_location_async	(	const int64_t	room_id,
		NIMChatRoomLocation	location,
		nim_chatroom_update_location_cb_func	cb,
		const char *	json_extension,
		const void *	user_data
	)

更新聊天室当前用户的位置信息，一般配合游戏业务使用

参数

room_id	聊天室 ID
location	位置信息结构体，见 NIMChatRoomLocation
cb	回调函数, 定义见nim_chatroom_def.h
json_extension	json扩展参数（备用，目前不需要）
user_data	APP的自定义用户数据，SDK只负责传回给回调函数cb，不做任何处理！

返回

void

nim_chatroom_update_my_role_async()

void nim_chatroom_update_my_role_async	(	const int64_t	room_id,
		const char *	role_info_json_str,
		bool	need_notify,
		const char *	notify_ext,
		const char *	json_extension,
		nim_chatroom_update_my_role_cb_func	cb,
		const void *	user_data
	)

更新我的信息，目前只支持更新kNIMChatRoomMemberInfoKeyNick,kNIMChatRoomMemberInfoKeyAvatar,kNIMChatRoomMemberInfoKeyExt三个字段

参数

[in]	room_id	聊天室ID
[in]	role_info_json_str	我的信息
[in]	need_notify	是否聊天室内广播通知
[in]	notify_ext	通知中的自定义字段，长度限制2048
[in]	json_extension	json扩展参数，针对固定成员，可配置更新的信息是否需要持久化，默认不持久化以及配置反垃圾相关参数{"need_save":false,"anti_spam_business_id":"xxxxx"}
[in]	cb	回调函数, 定义见nim_chatroom_def.h
[in]	user_data	APP的自定义用户数据，SDK只负责传回给回调函数cb，不做任何处理！

返回

void 无返回值

nim_chatroom_update_room_info_async()

void nim_chatroom_update_room_info_async	(	const int64_t	room_id,
		const char *	room_info_json_str,
		bool	need_notify,
		const char *	notify_ext,
		const char *	json_extension,
		nim_chatroom_update_room_info_cb_func	cb,
		const void *	user_data
	)

更新聊天室信息，目前只支持更新 kNIMChatRoomInfoKeyName, kNIMChatRoomInfoKeyAnnouncement, kNIMChatRoomInfoKeyBroadcastUrl, kNIMChatRoomInfoKeyExt, kNIMChatRoomInfoKeyQueuelevel 五个字段

参数

[in]	room_id	聊天室ID
[in]	room_info_json_str	聊天室信息
[in]	need_notify	是否聊天室内广播通知
[in]	notify_ext	通知中的自定义字段，长度限制2048
[in]	json_extension	json扩展参数 目前可用于配置反垃圾相关参数，格式{"anti_spam_business_id":"{\"textbid\":\"xxxx\",\"picbid\":\"xxxx\"}"}
[in]	cb	回调函数, 定义见nim_chatroom_def.h
[in]	user_data	APP的自定义用户数据，SDK只负责传回给回调函数cb，不做任何处理！

返回

void 无返回值

nim_chatroom_update_tags_async()

NIM_SDK_DLL_API void nim_chatroom_update_tags_async	(	const int64_t	room_id,
		NIMChatRoomUpdateTagsInfo	tags_info,
		nim_chatroom_update_tags_cb_func	cb,
		const char *	json_extension,
		const void *	user_data
	)

更新聊天室标签

参数

room_id	聊天室 ID
location	标签信息结构体，见 NIMChatRoomUpdateTagsInfo
cb	回调函数, 定义见nim_chatroom_def.h
json_extension	json扩展参数（备用，目前不需要）
user_data	APP的自定义用户数据，SDK只负责传回给回调函数cb，不做任何处理！

返回

void