游戏语音 接入FAQ_腾讯游戏服务
移动单机服务
>>游戏语音 接入FAQ
基本概念说明
1.码率   码率是影响音质的因素之一，但是高码率也会导致流量的上升。码率低，流量消耗也低。
2.OpenID   OpenID是每个玩家独一无二的标识，跟微信号和QQ号无关，1个游戏账户对应1个OpenID，游戏中同一OpenID不能同时进房。
计费
1.  Q：怎样算一个DAU？     A :（1）使用实时语音，进入房间算一个DAU;
         （2）使用语音消息，上传下载算一个DAU;
         （3）DAU按照OpenID去重计算。
2.  Q：去哪里开发票？
     A：GCloud控制台可以开具发票。
3.  Q：我在开通时已经充值了100元，为什么账户余额还是0？
     A：开通时充值&#x元是冻结款，可以解冻，不计入账户余额中。每日消耗将在次日从账户余额里扣除扣除。
4.  Q：我在腾讯云上已经充值，在GCloud后台账户中显示没有到账？
     A：请确认两个账户使用的是同一个QQ号。
5.  Q：语音服务设置了多个管理员，其他管理员充值的金额可以进行扣费吗？
     A：只有主账号账户可以充值、进行扣费和开发票。
体验专区
1.  Q：体验专区的语音服务和正式服务有什么区别？     A：体验专区的资源有限，仅能支&#x个语音DAU。
2.  Q：体验专区的服务可以正式上线吗？
     A：体验专区开通的语音服务，仅支&#x个语音DAU, 超过100个将无法加房。
如果游戏要正式上线，务必开通正式服务，在setappinfo中设置正式服务的gameid和game key。
服务开通
1.  Q：在国外发行的游戏可以使用GVoice吗？
     A：可以，目前GVoice已经在全球数10个国家和地区部署了服务，接下来还会继续增加部署地区。开通语音服务时，需要在setserverinfo中加入海外的服务器域名；域名地址在GCloud控制台开通语音服务时可以获取（国内国外地区都是），不填写此参数默认接入国内服务器。
2.  Q：在港澳台地区发行同一个版本的游戏，接入节点应该选哪个？
     A：建议选择香港节点。
SDK使用&接入相关问题
1.  Q：非游戏APP可以接入GVoice吗？
     A：可以。
2.  Q：端游可以接入GVoice吗？
     A：可以。
3.  Q：Flash页游可以使用GVoice吗？
     A：不可以。目前仅支持ActivityX的IE浏览器。
4.  Q： 房间数量有限制吗？
     A：没有限制。
5.  Q：房间内人数有限制吗？
     A：小队语音房间内人数不超过20人；国战语音房间没有人数限制，但是同时开麦的人数限制5人以内。
6.  Q：每秒最多能有几个人能同时进入国战语音房间？
     A：最多能支&#x人/s进入房间，超过会导致失败频率变高；游戏可以自己控制加房频率。
7.  Q：单个用户能同时进入多个房间吗？
     A：不能，一个OpenID同时只能存在于一个房间。
8.  Q：没有退房回调，可以重新加入房间吗？
     A：不可以，一定要等回调之后才能再次joinroom。joinroom和quitroom必须成对调用。不调用quitroom加房，会报错。
9.  Q：没人的房间会自动回收吗？
     A：房间没人的情况下，会自动回收，回收时间为30分钟之后。
10.Q：离线语音模式和实时语音模式可以共存吗？
     A：可以，做一下切换即可。
11.Q：roomid可以是中文吗？
     A：国战语音房间roomid可以使用中文，小队语音roomid仅支持英文、下划线或者数字。
12.Q：房间可以和区服ID精确对应吗？
     A：区服和房间ID，需要游戏自己保存映射关系。
13.Q：哪些场景需要调用quitroom然后再调用joinroom？
     A :（1）切换房间；
         （2）退出房间需要收到quitroom回调后才能再次加入房间。
14.Q：哪些场景不用调用quitroom就可以直接joinroom？
     A :（1）程序崩溃了；
         （2）程序退出了；
         （3）OnstatusUpdate 回调被调用了，已经被踢出房间。
15.Q：ApplyMessageKey收不到回调是什么原因？
     A：请检查是否有调用poll且是tick的循环调用，频率可以控制&#xms左右。
16.Q：语音消息，如何可以获取麦克风音量？
     A：调用GetMicLevel接口即可获得。
17.Q：GVoice能接入到UE4引擎吗？
     A：可以，按照cocos的C++接口进行接入即可。
18.Q：房间名可以创建两个相同的吗？
     A：使用同一个游戏ID，不可以创建房间名相同的房间。
19.Q：离线语音消息可以同时播放吗？如果正在播放一条语音消息，再来一条，会排队播放吗？
     A：不能同时播放，播放的顺序由游戏侧决定。
20.Q：Token有过期时间吗？如何判断过期？返回值是什么？
     A：Token 5min过期，过期会返回ERR_SVR的错误码。
21.Q：生成Token 的房间名的编码格式有没有影响？
     A：需采用GB2312。
22.Q：Android初始化的时候需要传key吗？
     A：Android的初始化分成两步，一个是Acvitiy里面的，不用key但是需要传入。
23.Q：国外环境第一次连接服务器超时？
     A：第一次连接，如果发现是新的帐号，服务器会先去读数据库，所以前几次会有超时，等数据库返回就不会超时了。
24.Q：从实时语音模式切换到语音消息模式，是否需要重新init？
     A：不需要，直接调用setmode即可，接入全流程中全流程只需init一次。
25.Q： 加入房间超时问题
     A：加入房间超时有多种原因，请对应解决：
         （1）游戏Key和游戏id不匹配；
         （2）没有在GCloud官网开通服务；
         （3） 网络不通；
         （4） 测试环境，DAU超过了100的限制。
26.Q：在editor和pc上，取消x86是ok，但取消x86_64会找不到dll，应该怎么解决？
     A：x86的配置 成x86的，64配置成64的。
unity64位默认会找64位的dll，不能取消，否则editor运行就会报dllnotfound。
27.Q：打开麦克风之后，游戏背景音乐变得很小声，是什么原因？
     A：属于正常现象，开麦克风后，为了消除回声、优化实时交流体验，会进入Voip通话模式，游戏背景音会变小。
28.Q：语音消息下载的语音，需要自己删除吗？
     A：需要。
29.Q： PlayRecordedFile 这个函数能播unity自己本地的MP3 ogg文件吗？
     A：不能，只能播放自己的文件。
30.Q：录音大概需要1秒才能生效？
     A：这是正常现象，同微信语音，建议UI上做一些调整，按下录音按键到录音按键显示按下这段时间可以适当延缓一点。
31.Q：语音接口的fileid长度有限制吗？
     A：控制&#x字节之内，在协议中也可以预留下fileid大小。
32.Q：Android OpenMic失败或者返回GCLOUD_VOICE_INTERNAL_TVE_ERR = 0x5001, //20481, internal TVE err, our used 以及GCLOUD_VOICE_PERMISSION_MIC_ERR = 0x3003, //12291, you have not right to access micphone in android, 应如何解决？
     A :（1）确认java中有没调用GCloudVoiceEngine的init方法，如下图所示：
         （2）确认下android.support.v4.jar的版本，因为语音引擎中使用了相关函数检查麦克风权限，因此需要确保该jar包版本&#x以上，否则，在Android 6.0上开麦克风会返回GCLOUD_VOICE_PERMISSION_MIC_ERR失败码。
33.Q：Xcode连接提示找不到SDK里面函数的实现，并有提示x86，是什么原因？
     A：SDK不支持Xcode模拟器调试，需要插入真机或者选择“Generic iOS Device&。
34.Q：Android部分较老的手机上出现 &cant find library&的出错提示，是什么原因？
     A：需要在ApplicationAvtivity里面做&System.loadLibrary(&GCloudVoice&)&操作，示例代码：
     static {
            try {
                 System.loadLibrary(&GCloudVoice&);
       } catch (UnsatisfiedLinkError e) {
              System.err.println(&load library failed!!!&);
       }
     }
35.Q：Android手机上出现“Cant find method ApolloVoiceUUID&字眼日志，是什么原因？
     A：检查SDK的jar包和.so文件是否来自同一个版本。
36.Q：Android手机上出现&Can&t Read config files&的异常日志，是什么问题？
     A：Android检查Assets目录是否正常合入，iOS检查Bundle文件是否加入到Xcode工程中。
37.Q：自行修改AudioSession会影响语音功能吗？
     A：会。因为AudioSession是App单例，所以会影响功能使用。
38.Q： 如何实现文档中Unity接入的第二步：修改Java文件？
     A：有两种方案，任选其一即可
          （1）把Unity导出一个Android工程，然后在里面修改Java代码。第二种是按照Unity插件的
          （2）按照Unity插件的形式，在Plugins/Android目录下放一个集成了UnityPlayerActivity的ApplicationActiviy的类，然后在里面实现。
39.Q：iOS链接报错: dumplicate symbol * in: /libGCloudVoice.a(.o), 应该如何解决？
     A：工程设置中的other link flag 不要使用all_load，若有其他库需要使用all-load，可以使用force_load链接相关库。
41.Q：iOS接入后运行崩溃，是什么原因？
     A：在iOS10.0及以上系统需要在工程Info.plist中添加权限 Privacy - Microphone Useage DescriptioniOS接入为静态库容易与其他语音相关组件发生函数同名导致调用过程中出错，因此建议接入时检查之前接入组件是否已经删除。
42.Q：applymessagekey超时错误，是什么问题？
     A：applymessagekey出现超时错误，请首先确认设置的appid和key是否已经开通了语音服务；如果已经开通语音服务，仍出现超时错误，请检查网络是否正常。
43.Q：两人加入同一房间后听不到对方说话；
     A :（1）确认两人加入的是同一个房间。
         （2）确认说话方打开了麦克风和收听方打开了扬声器。
         （3）两个加入同一房间是否用了同样的OpenId(在SetAppInfo中设置），请确保进入同一房间的用户具有不同的OpenId。
44.Q：离线语音和语音识别共存时，应该如何设置模式？
     A：设置成语音识别模式即可。
45.Q：录音上传提示失败，应该如何处理？
     A：参考日志发现文件长度为0，查看所给路径是否存在，要保证目录已经创建；另外，要具体到文件名，比如/sdcard/com.qq.gcloud/voice/11.dat。
46.Q：unity加入房间成功，ios平台上有调用poll，但是收不到回调信息？应该如何处理？
     A：这个会在Unity5.5版本出现，主要是因为unity5.5平台有改动，导致poll失效，更新到最新版本GVoice即可。
47.Q：调用JoinRoom、QuitRoom、ApplyMessageKey等相关函数后，没有回调，是什么问题？
     A：检查是否有持续调用Poll函数，来驱动获取回调消息。
48.Q：DownloadRecordFile出错， log出现response status = 400 Bad Request，是什么原因？
     A：很有可能是传入的FileID非法，可通过HardCode一个合法的fileid来验证。
49.Q：Mac下Unity中Editor直接运行，报DLlNotFound错误，是什么原因？
     A：目前不支持Mac下直接运行Unity Editor调试，可在Win下Unity Editor来调试。
50.Q：Windows中运行Unity Editor调试时，提示DllNotFound，应该如何处理？
     A：查看Unity工程对应目录中是否有添加X86和x86_64文件、里面是否有dll和dll配置是否如图所示
51.Q：如何获取客户端日志？
     A：Windows使用Ｄebugview或者运行后使用vs的attach到进程在outputwindow查看日志；Ａndroid使用logcat；
iOS使用Xcode 来获取日志。
52.Q：程序运行时崩溃，提示“findclass error”，应该如何处理？
     A：将Apk反编译，确定GCloudVoice.jar已经编译到Apk中了。
53.Q：离线语音和语音识别模式共存时，应该如何设置模式？
     A：设置语音识别模式即可。
54.Q：iOS编译报错，应该如何处理？
     A：查看是否有链接系统库:
55.Q：iOS接入后运行崩溃，是什么原因？
    A：在iOS10.0及以上系统需要在工程Info.plist中添加权限 Privacy-Microphone Useage DescriptioniOS接入为静态库容易与其他语音相关组件发生函数同名导致调用过程中出错，因此建议接入时检查之前接入组件是否已经删除。
    {}