【端午节社区活动】文档找茬挑战赛

[yuanzhiqiang]

文档链接：https://docs.agora.io/cn/Agora%20Platform/sdk_behaviors

问题：最下面的web sdk，断线10s对端收到stream remove

建议：再加上20s对端还会收到peer leave，只写一个stream客户无法判断是否自动退出

[yuanzhiqiang]

https://jira.agora.io/browse/DOC-1707

[yuanzhiqiang]

[tinayuan0917]

已经修复的不要再提了，谢谢

[yangshangbin]

是不是可以描述一下，这个是获取当前用户加入的频道数。

[linshuo]

我有两个官方文档优化建议：

1. 现在文档中对于E2E通信过程没有一个总体的描述，这样用户在讨论问题时时长出现信息不同步的情况，我结合内部的资料，省略敏感信息，绘制了一幅E2E通信过程，请文档团队审阅，如果适合可以增加到文档上，帮助客户更好地理解通信过程：
   

   

2. SDK2.3.2以后对SDK状态机做了优化，尤其对于断线重连情况做了更好的规范，这块描述比较散，客户理解不够透彻。我结合官网API描述绘制了SDK状态机示意图，API团队也帮忙review，希望可以帮助客户更好地理解SDK的状态，变化触发条件：
   State Machine状态变化示意图：
   

   
   
   Reason Machine状态变化示意图：
   
   
   
   2.3.2以前SDK状态机变化示意图：
   
   
   
   2.3.2以后SDK状态机变化示意图：
   
   

[xuxuewen]

文档链接：https://docs.agora.io/cn/Video/API%20Reference/oc/Constants/AgoraWarningCode.html
问题：AgoraWarningCodeAdmPlayoutAudioLowlevel和AgoraWarningCodeAdmRecordAudioLowlevel code重复

修改： AgoraWarningCodeAdmPlayoutAudioLowlevel对应code为1032

[chenjing]

文档链接：https://docs-preview.agoralab.co/cn/Interactive%20Broadcast/momo_media_relay_api_reference_android?platform=Android
问题：

文字注释写反了

[xuxuewen]

文档链接：https://docs.agora.io/cn/Video/API%20Reference/oc/Classes/AgoraRtcEngineKit.html#//api/name/setDefaultAudioRouteToSpeakerphone:
https://docs.agora.io/cn/Video/API%20Reference/java/classio_1_1agora_1_1rtc_1_1_rtc_engine.html#a8f89328fab2054d74f9dfa7819458866

问题：Android/iOS文档，见截图红框

实际现象：setDefaultAudioRoutetoSpeakerphone接口在音视频模式均work

[liuzihe]

https://docs.agora.io/cn/Voice/API%20Reference/oc/Constants/AgoraAudioMixingErrorCode.html

这个errorcode同前面android 平台的解释一样，

windows 也是一样
https://docs.agora.io/cn/Voice/API%20Reference/cpp/namespaceagora_1_1rtc.html#aedc2af544582cf31378cc89810d8da7a

应该都是播放中非预期的EOF/EOS、意外的错误中断，并非打开中断

英文文档

三个平台的解释说明也应该保持一致

[yangshangbin]

我看了here write的左侧选择栏，感觉比较流畅，我们的选择栏给我的感觉一卡一卡的，
能不能优化一下，咱们的左侧栏我看了一个可能都会直接跳转到api列表，但是here write的左侧栏能让我一直看完。。
我又录屏但是传不上来

[ChenMeng]

问题已修复：https://docs.agora.io/cn/Video/API%20Reference/java/classio_1_1agora_1_1rtc_1_1_i_rtc_engine_event_handler.html#a76be982389183c5fe3f6e4b03eaa3bd4，谢谢。

[derek]

1、请提供发现问题的文档链接
英文文档 https://docs.agora.io/en/Voice/volume_android_audio?platform=Android
中文文档 https://docs.agora.io/cn/Voice/volume_android_audio?platform=Android

2、请指出哪里有问题
在文档中“获取用户音量”/“ Get the Data of the Loudest Speaker”部分。

在英文文档中“This callback gets the ID of the loudest speaker for a certain period”这句话会一般理解为“一段时间内，返回说话音量峰值最大的用户ID”。而在中文文档中，我们的理解是“累积音量最大者”。

3、请提供你建议的修改方式
确认应该是峰值音量还是累积音量，修改中文或者英文文档。

[derek]

1、请提供发现问题的文档链接
英文文档 https://docs.agora.io/en/Audio%20Broadcast/dashboard_restful_live?platform=All_Platforms#6-online-statistics-query-api

中文文档 https://docs.agora.io/cn/Audio%20Broadcast/dashboard_restful_live?platform=All_Platforms#6-在线查询频道信息-api

2、请指出哪里有问题
文档中表明“RESTful API 仅支持 HTTPS”。

但是在中文文档中的“ 在线查询频道信息 API” 和英文文档中的“ Online Statistics Query API”，BaseUrl是 http://api.agora.io/dev/v1/ 而不是 https。

3、请提供你建议的修改方式
确认是否应修改为https，同步修改中文或者英文文档。

[yangshangbin]

实时消息----快速开始----创建频道内容如下：

这块我理解是依赖login的，如果不login是无法创建频道的，所以我觉得这个代码的上面应该加上和login一块的时候如何使用。

[5661]

https://docs.agora.io/cn/Recording/recording_cmd_cpp?platform=CPP
https://docs.agora.io/cn/Recording/recording_cmd_java?platform=Java

当前文件中给出的 killall -s 10 recorder_local 是以进程名的方式开始和暂停录制的， 不适用于多进程录制，

建议增加如下示例，通过对应的进程号，手动控制单个录制进程
1，获取录制进程pi d : ps aux | grep ‘channelName’
2, 根据进程号来开始，暂停
kill -s 10 PID 开始录制
kill -s 12 PID 暂停录制，pid是进程号

[jianghucheng]

https://docs.agora.io/cn/Signaling/key_signaling?platform=All%20Platforms

信令token 使用描述不完善 和 媒体token用法差太多 太简单 并且dashboard里面的信令开关很容易让人产生误会 需要尽快备注

[jianghucheng]

https://docs.agora.io/cn/Interactive%20Broadcast/API%20Reference/cpp/index.html

[yangshangbin]

想问一下 error错误1能否跟研发对对，这块到底是什么错误才会报错，开发者就可以自行排查了。

[longxin]

https://docs.agora.io/cn/Interactive%20Broadcast/release_web_video?platform=Web