tencent cloud

游戏多媒体引擎

产品动态
产品介绍
产品概述
优势特性
产品功能
应用场景
安全合规认证
新手指引
产品计费
免费额度
购买指南
SDK 下载指引
产品功能体验
基本功能演示
场景化 Demo 体验
控制台指南
用量查看
服务开通
快速入门
快速接入 SDK
快速接入 Sample Project
基础功能开发指南
鉴权密钥
实时语音角色设置
音质选择
进阶功能开发指南
服务端录制
万人范围语音
3D 音效
音效与伴奏
网络音频流转发路由
自定义消息通道
如何应对公司防火墙限制
语言参数参考列表
房间管理功能
客户端 API
Unity SDK
Unreal Engine SDK
Cocos2D SDK
Windows SDK
iOS SDK
Android SDK
macOS SDK
H5SDK
Electron SDK
Flutter SDK
SDK 版本升级指引
错误码
编译工具链文档
服务端 API
History
Introduction
API Category
Usage APIs
Recording APIs
Making API Requests
Voice Chat APIs
Application APIs
Data Types
Error Codes
常见问题
产品功能问题
问题解决指南
计费相关问题
Sample Project 使用问题
一般性问题
鉴权相关问题
实时语音进房失败问题
实时语音无声及音频问题
网络问题
语音转文本问题
工程导出问题
服务协议
服务等级协议
联系我们
词汇表
GME 政策
数据处理和安全协议
隐私协议
文档游戏多媒体引擎进阶功能开发指南房间管理功能

房间管理功能

PDF
聚焦模式
字号
最后更新时间： 2023-04-27 17:17:14
注意：GME 3.x 版本暂不支持房间管理功能。
为方便开发者快速接入房间管理服务，这里向您介绍房间管理服务的使用场景以及接入流程。

功能简介

通过客户端房间管理接口，可以简单实现对房间内成员的管理、以及对房间内成员上下麦的管理。

使用场景

例如在狼人杀场景中，作为主持人可以通过 EnableMic 控制其他玩家打开麦克风发言；当某位玩家已经“死亡”，不需要听房间内声音或者操作麦克风说话，则通过 ForbidUserOperation 接口禁止该玩家操作设备。

前提条件

已开通实时语音服务：可参见 语音服务开通指引。
已接入GME SDK：包括核心接口和实时语音接口的接入，详情可参见 Native SDK 快速接入、Unity SDK 快速接入、Unreal SDK 快速接入。
说明
此功能不支持 H5 SDK。

接入流程

类名：ITMGRoomManager

GME 房间管理功能在进房后才可调用，且只能修改房间内成员的状态。 所有接口的结果会通过 ITMG_MAIN_EVNET_TYPE_ROOM_MANAGEMENT_OPERATOR 回调，回调详情请参考 回调处理。

接口列表

类型
接口
控制采集
EnableMic、 EnableAudioCaptureDevice、EnableAudioSend
控制播放
EnableSpeaker、 EnableAudioPlayDevice、EnableAudioRecv
设备状态获取
GetMicState、 GetSpeakerState
敏感接口
ForbidUserOperation

采集管理相关接口

采集管理接口包含麦克风管理、音频上行管理以及采集硬件设备管理。其中麦克风管理相当于音频上行管理加上采集硬件设备管理。

采集管理

调用此接口打开或关闭房间内某用户的麦克风，调用成功后，该用户的麦克风将被关闭或打开。 EnableMic 相当于同时调用 EnableAudioSend 及 EnableAudioCaptureDevice。

函数原型

Android
iOS
public abstract int EnableMic(boolean isEnabled,String receiverID);
-(QAVResult)EnableMic:(BOOL)enable Receiver:(NSString *)receiverID;
参数
类型
含义
enable
BOOL
YES：打开某用户麦克风，NO：关闭某用户麦克风
receiverID
NSString*
填入目标用户 OpenId

回调

回调参数为 ITMG_ROOM_MANAGEMENT_MIC_OP。

音频流发送管理

调用此接口打开或关闭房间内某用户的音频上行。调用成功后，该用户的音频上行将被关闭或打开，但不影响麦克风采集。

函数原型

Android
iOS
public abstract int EnableAudioSend(boolean isEnabled,String receiverID);
-(QAVResult)EnableAudioSend:(BOOL)enable Receiver:(NSString *)receiverID;
参数
类型
含义
enable
BOOL
YES：打开某用户上行，NO：关闭某用户上行
receiverID
NSString*
填入目标用户 OpenId

回调

回调参数为 ITMG_ROOM_MANAGEMENT_AUDIO_SEND_OP。

音频采集硬件管理

调用此接口打开或关闭房间内某用户的音频采集硬件设备。调用成功后，该用户的音频采集硬件设备将被关闭或打开，但不影响上行。

函数原型

Android
iOS
public abstract int EnableAudioCaptureDevice(boolean isEnabled,String receiverID);
-(QAVResult)EnableAudioCaptureDevice:(BOOL)enabled Receiver:(NSString *)receiverID;
参数
类型
含义
enable
BOOL
YES：打开某用户音频采集硬件设备，NO：关闭某用户音频采集硬件设备
receiverID
NSString*
填入目标用户 OpenId

回调

回调参数为 ITMG_ROOM_MANAGEMENT_CAPTURE_OP。

播放管理相关接口

播放管理接口包含扬声器管理、音频下行管理以及播放硬件设备管理。其中扬声器管理相当于音频下行管理加上播放硬件设备管理。

播放管理

调用此接口打开或关闭房间内某用户的扬声器。调用成功后，该用户的扬声器将被关闭或打开，听到房间内的音频声音。 EnableSpeaker 相当于同时调用 EnableAudioRecv 及 EnableAudioPlayDevice。

函数原型

Android
iOS
public abstract int EnableSpeaker(boolean isEnabled,String receiverID);
-(QAVResult)EnableSpeaker:(BOOL)enable Receiver:(NSString *)receiverID;
参数
类型
含义
enable
BOOL
YES ：打开某用户扬声器，NO：关闭某用户扬声器
receiverID
NSString*
填入目标用户 OpenId

回调

回调参数为 ITMG_ROOM_MANAGEMENT_SPEAKER_OP。

音频流接收管理

调用此接口打开或关闭房间内某用户的音频下行。调用成功后，该用户的音频下行将被关闭或打开，但不影响播放设备。

函数原型

Android
iOS
public abstract int EnableAudioRecv(boolean isEnabled,String receiverID);
-(QAVResult)EnableAudioRecv:(BOOL)enabled Receiver:(NSString *)receiverID;
参数
类型
含义
enable
BOOL
YES ：打开某用户音频下行，NO：关闭某用户音频下行
receiverID
NSString*
填入目标用户 OpenId

回调

回调参数为 ITMG_ROOM_MANAGEMENT_AUDIO_REC_OP。

音频播放硬件管理

调用此接口打开或关闭房间内某用户的音频播放硬件设备。调用成功后，该用户的音频播放硬件设备将被关闭或打开，但不影响下行。

函数原型

Android
iOS
public abstract int EnableAudioPlayDevice(boolean isEnabled,String receiverID);
-(QAVResult)EnableAudioPlayDevice:(BOOL)enabled Receiver:(NSString *)receiverID;
参数
类型
含义
enable
BOOL
YES ：打开某用户音频播放硬件设备，NO：关闭某用户音频播放硬件设备
receiverID
NSString*
填入目标用户 OpenId

回调

回调参数为 ITMG_ROOM_MANAGEMENT_PLAY_OP。

获取成员状态接口

获取某人采集状态

调用此接口，获取房间内某成员的麦克风状态。

函数原型

Android
iOS
public abstract int GetMicState(String receiverID);
-(QAVResult)GetMicState:(NSString *)receiverID;
参数
类型
含义
receiverID
NSString*
填入目标用户 OpenId

回调

回调参数为 ITMG_ROOM_MANAGEMENT_GET_MIC_STATE。

获取某人播放状态

调用此接口，获取房间内某成员的扬声器状态。

函数原型

Android
iOS
public abstract int GetSpeakerState(String receiverID);
-(QAVResult)GetSpeakerState:(NSString *)receiverID;

回调

回调参数为 ITMG_ROOM_MANAGEMENT_GET_SPEAKER_STATE。

禁止某位成员操作采集及播放

成员进房默认为允许操作麦克风及扬声器，调用此接口可以禁止房间内的某位成员操作麦克风及扬声器，在该成员退出房间后此功能失效。
Android
iOS
public  abstract int ForbidUserOperation(boolean isEnabled,String receiverID);
-(QAVResult)ForbidUserOperation:(BOOL)enable Receiver:(NSString *)receiverID;
参数
类型
含义
enable
BOOL
YES：禁止某用户操作设备，NO：允许某用户操作设备
receiverID
NSString*
填入目标用户 OpenId

回调

回调参数为 ITMG_ROOM_MANAGERMENT_FOBIN_OP。

回调处理

与 GME 其他回调相同，房间管理的回调也在 OnEvent 中处理，事件名称为 ITMG_MAIN_EVNET_TYPE_ROOM_MANAGEMENT_OPERATOR，事件会返回一个结构体，具体包含的内容如下。

回调参数

参数
类型
含义
SenderID
NSString
事件发送者 ID，如果与自己 OpenId 相同，即为本端发送的命令
ReceiverID
NSString
事件接收者 ID，如果与自己 OpenId 相同，即为本端接收的命令
OperateType
NSNumber
事件类型
Result
NSNumber
事件结果，0为成功
OperateValue
NSNumber
命令详情

OperateType

数值
事件类型
含义
0
ITMG_ROOM_MANAGEMENT_CAPTURE_OP
控制采集设备硬件回调
1
ITMG_ROOM_MANAGEMENT_PLAY_OP
控制播放设备硬件回调
2
ITMG_ROOM_MANAGEMENT_AUDIO_SEND_OP
控制上行回调
3
ITMG_ROOM_MANAGEMENT_AUDIO_REC_OP
控制下行回调
4
ITMG_ROOM_MANAGEMENT_MIC_OP
控制麦克风回调
5
ITMG_ROOM_MANAGEMENT_PLAY_OP
控制扬声器回调
6
ITMG_ROOM_MANAGEMENT_GET_MIC_STATE
获取麦克风状态
7
ITMG_ROOM_MANAGEMENT_GET_SPEAKER_STATE
获取扬声器状态
8
ITMG_ROOM_MANAGERMENT_FOBIN_OP
禁止操作麦克风及扬声器事件

OperateValue

成员
含义
boolValue
0：关闭命令，1：打开命令

示例代码

Android
iOS
 public void OnEvent(ITMGContext.ITMG_MAIN_EVENT_TYPE type, Intent data) {
 if (ITMGContext.ITMG_MAIN_EVENT_TYPE.ITMG_MAIN_EVNET_TYPE_ROOM_MANAGEMENT_OPERATOR== type) {

            ArrayList<String> operatorArr = new ArrayList<String>();
            operatorArr.add("采集");
            operatorArr.add("播放");
            operatorArr.add("上行");
            operatorArr.add("下行");
            operatorArr.add("采集上行");
            operatorArr.add("播放下行");
            operatorArr.add("mic状态");
            operatorArr.add("spk状态");
            operatorArr.add("禁止操作mic/speak");

            String SenderID =  data.getStringExtra("SenderID");
            String ReceiverID = data.getStringExtra("ReceiverID");
            int OperateType = data.getIntExtra("OperateType",-1000);

            int Result =data.getIntExtra("Result",-1000);
            boolean OperateValue = data.getBooleanExtra("OperateValue",false);
            if (OperateType == -1000 ||Result == -1000) {
                return;
            }
            if (SenderID.equals(identifier)) {
                if (OperateType == ITMGContext.ITMG_ROOM_MANAGEMENT_GET_MIC_STATE || OperateType == ITMGContext.ITMG_ROOM_MANAGEMENT_GET_SPEAKER_STATE) {
                    Toast.makeText(getActivity(), String.format("发送给id:%s 的%s操作,结果:%s", ReceiverID, operatorArr.get(OperateType), OperateValue ? "开" : "关"), Toast.LENGTH_LONG).show();
                } else  {
                    Toast.makeText(getActivity(), String.format("发送给id:%s 的%s%s操作,结果:%d", ReceiverID, operatorArr.get(OperateType), OperateValue ? "开" : "关", Result), Toast.LENGTH_LONG).show();
                }

            } else if (ReceiverID.equals(identifier)||ReceiverID.equals("ALL")) {
                if (Result == 0) {
                    switch (OperateType) {
                        case ITMGContext.ITMG_ROOM_MANAGEMENT_CAPTURE_OP:
                        {
                            if (!OperateValue) {
                                mSwitchCapture.setChecked(OperateValue);
                            } else  {
                                AlertDialog.Builder dialog = new AlertDialog.Builder (getActivity());  //创建对象
                                dialog.setTitle("是否要打开设备采集");
                                dialog.setMessage("");
                                dialog.setCancelable(false);
                                dialog.setPositiveButton("开", new DialogInterface.OnClickListener() {
                                    //设置确定按钮的点击事件
                                    @Override
                                    public void onClick(DialogInterface dialog, int which) {
                                        mSwitchCapture.setChecked(true);
                                        ITMGContext.GetInstance(getActivity()).GetAudioCtrl().EnableAudioCaptureDevice(true);
                                    }
                                });
                                dialog.setNegativeButton("关", new DialogInterface.OnClickListener() {
                                    //设置取消按钮的点击事件
                                    @Override
                                    public void onClick(DialogInterface dialog, int which) {
                                    }
                                });
                                dialog.show();
                            }

                        }
                            break;
                        case ITMGContext.ITMG_ROOM_MANAGEMENT_PLAY_OP:
                        {
                            mSwitchPlayDevice.setChecked(OperateValue);
                        }
                            break;
                        case ITMGContext.ITMG_ROOM_MANAGEMENT_AUDIO_SEND_OP:
                        {
                            if (!OperateValue) {
                                mSwitchSend.setChecked(OperateValue);
                            } else  {
                                AlertDialog.Builder dialog = new AlertDialog.Builder (getActivity());  //创建对象
                                dialog.setTitle("是否要打开上行");
                                dialog.setMessage("");
                                dialog.setCancelable(false);
                                dialog.setPositiveButton("开", new DialogInterface.OnClickListener() {
                                    //设置确定按钮的点击事件
                                    @Override
                                    public void onClick(DialogInterface dialog, int which) {
                                        mSwitchSend.setChecked(true);
                                        ITMGContext.GetInstance(getActivity()).GetAudioCtrl().EnableAudioSend(true);
                                    }
                                });
                                dialog.setNegativeButton("关", new DialogInterface.OnClickListener() {
                                    //设置取消按钮的点击事件
                                    @Override
                                    public void onClick(DialogInterface dialog, int which) {
                                    }
                                });
                                dialog.show();
                            }
                        }
                            break;
                        case ITMGContext.ITMG_ROOM_MANAGEMENT_AUDIO_REC_OP:
                         {
                             mSwitchRecv.setChecked(OperateValue);
                        }
                            break;
                        case ITMGContext.ITMG_ROOM_MANAGEMENT_MIC_OP:
                         {
                             if (!OperateValue) {
                                 mSwitchCapture.setChecked(OperateValue);
                                 mSwitchSend.setChecked(OperateValue);
                             }  else  {
                                 AlertDialog.Builder dialog = new AlertDialog.Builder (getActivity());  //创建对象
                                 dialog.setTitle("是否要打开采集和上行");
                                 dialog.setMessage("");
                                 dialog.setCancelable(false);
                                 dialog.setPositiveButton("开", new DialogInterface.OnClickListener() {
                                     //设置确定按钮的点击事件
                                     @Override
                                     public void onClick(DialogInterface dialog, int which) {
                                         mSwitchCapture.setChecked(true);
                                         mSwitchSend.setChecked(true);
                                         ITMGContext.GetInstance(getActivity()).GetAudioCtrl().EnableMic(true);
                                     }
                                 });
                                 dialog.setNegativeButton("关", new DialogInterface.OnClickListener() {
                                     //设置取消按钮的点击事件
                                     @Override
                                     public void onClick(DialogInterface dialog, int which) {
                                     }
                                 });
                                 dialog.show();
                             }
                          }
                            break;
                        case ITMGContext.ITMG_ROOM_MANAGEMENT_SPEAKER_OP:
                        {
                            mSwitchPlayDevice.setChecked(OperateValue);
                            mSwitchRecv.setChecked(OperateValue);
                        }
                            break;

                    }
                }
                if (OperateType == ITMGContext.ITMG_ROOM_MANAGEMENT_GET_MIC_STATE || OperateType == ITMGContext.ITMG_ROOM_MANAGEMENT_GET_SPEAKER_STATE)
                {
                    Toast.makeText(getActivity(), String.format("收到来自id:%s 的%s操作,结果:%s",SenderID,operatorArr.get(OperateType),OperateValue?"开":"关"), Toast.LENGTH_LONG).show();
                }
                else if (OperateType == ITMGContext.ITMG_ROOM_MANAGEMENT_SPEAKER_OP || OperateType == ITMGContext.ITMG_ROOM_MANAGEMENT_AUDIO_REC_OP|| OperateType == ITMGContext.ITMG_ROOM_MANAGEMENT_PLAY_OP|| OperateType == ITMGContext.ITMG_ROOM_MANAGERMENT_FOBIN_OP){
                    Toast.makeText(getActivity(), String.format("收到来自id:%s 的%s%s操作,结果:%d",SenderID,operatorArr.get(OperateType),OperateValue?"开":"关",Result), Toast.LENGTH_LONG).show();
                } else if (OperateValue == false) {
                    Toast.makeText(getActivity(), String.format("收到来自id:%s 的%s%s操作,结果:%d",SenderID,operatorArr.get(OperateType),OperateValue?"开":"关",Result), Toast.LENGTH_LONG).show();
                }
            }
 }
-(void)OnEvent:(ITMG_MAIN_EVENT_TYPE)eventType data:(NSDictionary *)data{
    NSString* log =[NSString stringWithFormat:@"OnEvent:%d,data:%@", (int)eventType, data];
    [self showLog:log];
    NSLog(@"====%@====",log);
    switch (eventType) {
        case ITMG_MAIN_EVNET_TYPE_ROOM_MANAGEMENT_OPERATOR:
        {
            NSArray *operatorArr = @[@"采集",@"播放",@"上行",@"下行",@"采集上行",@"播放下行",@"踢人",@"mic状态",@"spk状态",@"禁止操作mic/speak"];
            // _openId
            NSString *SenderID = [data objectForKey:@"SenderID"];
            NSString *ReceiverID = [data objectForKey:@"ReceiverID"];
            NSNumber *OperateType = [data objectForKey:@"OperateType"];
            NSNumber *Result = [data objectForKey:@"Result"];
            NSNumber *OperateValue = [data objectForKey:@"OperateValue"];

            //自己发出去的命令
            if ([SenderID isEqualToString:_openId]) {
                if (OperateType.intValue == ITMG_ROOM_MANAGEMENT_GET_MIC_STATE || OperateType.intValue == ITMG_ROOM_MANAGEMENT_GET_SPEAKER_STATE) {
                          NSString *alterString = [NSString stringWithFormat:@"发送给id:%@ 的%@操作,结果:%@",ReceiverID,operatorArr[OperateType.intValue],OperateValue.boolValue?@"开":@"关"];
                                             UIAlertView *alert = [[UIAlertView alloc] initWithTitle:@"房间管理操作" message:alterString delegate:NULL cancelButtonTitle:@"OK" otherButtonTitles:nil];
                                             [alert show];
                }
                else
                {
                    NSString *alterString = [NSString stringWithFormat:@"发送给id:%@ 的%@%@操作,结果:%@",ReceiverID,OperateValue.boolValue?@"开":@"关",operatorArr[OperateType.intValue],Result];
                               UIAlertView *alert = [[UIAlertView alloc] initWithTitle:@"房间管理操作" message:alterString delegate:NULL cancelButtonTitle:@"OK" otherButtonTitles:nil];
                               [alert show];
                }


            } 
            else if([ReceiverID isEqualToString:_openId] ){ //别人发过来的命令
                if (Result.intValue == 0) {
                    switch (OperateType.intValue) {
                        case ITMG_ROOM_MANAGEMENT_CAPTURE_OP:{
                            [_micSwitch setOn:OperateValue.boolValue animated:true];
                        }
                            break;
                        case ITMG_ROOM_MANAGEMENT_PLAY_OP:{
                            [_speakerSwitch setOn:OperateValue.boolValue animated:true];
                            }
                            break;
                        case ITMG_ROOM_MANAGEMENT_AUDIO_SEND_OP:{
                            [_sendSwitch setOn:OperateValue.boolValue animated:true];
                        }
                            break;
                        case ITMG_ROOM_MANAGEMENT_AUDIO_REC_OP:{
                            [_recvSwitch setOn:OperateValue.boolValue animated:true];
                        }
                            break;
                        case ITMG_ROOM_MANAGEMENT_MIC_OP:{
                        [_micSwitch setOn:OperateValue.boolValue animated:true];
                        [_sendSwitch setOn:OperateValue.boolValue animated:true];
                        }
                            break;
                        case ITMG_ROOM_MANAGEMENT_SPEAKER_OP:{
                        [_speakerSwitch setOn:OperateValue.boolValue animated:true];
                        [_recvSwitch setOn:OperateValue.boolValue animated:true];

                        }
                            break;
                        default:
                            break;
                    }

                if (OperateType.intValue == ITMG_ROOM_MANAGEMENT_GET_MIC_STATE || OperateType.intValue == ITMG_ROOM_MANAGEMENT_GET_SPEAKER_STATE) {
                        NSString *alterString = [NSString stringWithFormat:@"收到id:%@ 发送来的%@操作,结果:%@",SenderID,operatorArr[OperateType.intValue],OperateValue.boolValue?@"开":@"关"];
                                UIAlertView *alert = [[UIAlertView alloc] initWithTitle:@"房间管理操作" message:alterString delegate:NULL cancelButtonTitle:@"OK" otherButtonTitles:nil];
                                [alert show];
                    }
                else{
                        NSString *alterString = [NSString stringWithFormat:@"收到id:%@ 发送来的%@%@操作,结果:%@",SenderID,OperateValue.boolValue?@"开":@"关",operatorArr[OperateType.intValue],Result];
                              UIAlertView *alert = [[UIAlertView alloc] initWithTitle:@"房间管理操作" message:alterString delegate:NULL cancelButtonTitle:@"OK" otherButtonTitles:nil];
                              [alert show];
                    }
                }
            }
        }
        break;
}

上一篇: 语言参数参考列表下一篇: 集成 SDK

帮助和支持

本页内容是否解决了您的问题？

填写满意度调查问卷，共创更好文档体验。

文档反馈