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


#1

背景

众所周知,文档对于开发者的重要性,为了更加有针对性的、更快速的优化,声网Agora特推出为期二个月的挑战赛。好胆你就来!:point_down:

声网Agora文档中心传送门

活动主题

文档找茬挑战赛

面向人群

面向所有声网Agora的用户

活动时间

2019-05-05T16:00:00Z2019-06-29T16:00:00Z

找茬方向

  1. 内容正确性:例如描述和实际使用不符等。
  2. 内容不清晰:例如看不懂或者逻辑有问题等。
  3. 内容缺失:需要更多信息补充,指出需要补充的信息等。
  4. 存在疑问:找不到想要的信息,不知道是不是缺失,给出优化建议等。

回帖格式

1、请提供发现问题的文档链接
<请贴上官网或指定内容的链接>

2、请指出哪里有问题
<请开始你的表演,填写内容,可以用章节或截图代替>

3、请提供你建议的修改方式
<请开始你的表演,填写内容, 最好确认内容的正确性>

奖励规则

  1. 特等奖、一、二、三等奖将均由声网Agora文档团队评比选出。
  2. 只要参与即可获得「端午节」活动勋章。集齐10个「活动徽章」,即可兑换 技术大会门票 一张。具体请点击徽章有什么用?

奖品设置

  • 特别奖(2名):AirPods 2
  • 一等奖(3名):端午定制礼盒
  • 二等奖(3名):Agora限量版帽衫
  • 三等奖(15名):AgoraT恤
  • 参与奖:社区活动勋章「端午节」

image

快来参加吧,点击声网Agora文档中心传送门,开启找茬之旅!直接回贴即可参与活动哦 :wink:

常见Q&A

1、不同的人上报相同的问题,怎么办?
由于问题是以回帖形式发布,因此我们以回帖顺序来判定,先发者得分。

2、什么时候可以拿到奖品?:star_struck:
活动结束后一周内,社区工作人员会在本帖顶部公布结果,并且私信获奖人员。请大家关注本帖,并留意 @Tanzhu 私信哦

3、提出来的问题何时可以修复?
我们会在活动结束一个月内将能修复的修复,并发公告。


于隐藏 #2

列出 #3

于置顶 #4

#5

https://docs.agora.io/cn/Interactive%20Broadcast/screensharing_mac

let displayId = 0
let rectangle = CGRect.zero
let parameters = AgoraScreenCaptureParameters()
parameters.dimensions = CGSize.zero
parameters.frameRate = 15
parameters.bitrate = 1000

#6

let displayId = 0 虽然代表整个屏幕 但是对于高清屏幕来说 不一定是0 随意准备的屏幕共享 需要用

// 获取屏幕列表
NSArray *screens = [NSScreen screens];
for (NSUInteger i = 0; i < [screens count]; ++i) {
// 获取屏幕详情
NSDictionary* device_description = [[screen objectAtIndex: i] deviceDescription];
// 获取 displayId
CGDirectDisplayID displayId = ([[device_description  objectForKey:@"NSScreenNumber"] intValue]);
}

来获取


#7

文档中很多回调API都没有注明是哪个API调用后触发的。

比如: onUserMuteAudio、 onUserMuteVideo、 onUserEnableVideo等等,这些回调接口都没有注明是哪个API调用后触发的。同时如enableLocalAudio之类的API,也没注明相应的回调。
https://docs.agora.io/cn/Interactive%20Broadcast/API%20Reference/java/classio_1_1agora_1_1rtc_1_1_i_rtc_engine_event_handler.html#a42ecab512f9fc5ba0785abd9f4d8b2d9

Android、iOS、微信小程序、windows以及web等都有这样的情况。

总而言,文档中缺少两点注释:一是接口调用的回调接口;二是回调接口的触发接口。


#8

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

onNetworkQuality 观众的下行质量也会回调 不仅仅是主播


#9

https://www.agora.io/cn/voicecall/
image
微信公众号的小图标位置


#10

亲,同步一下,这个是官网的问题哈,不是文档的问题。 文档问题看这里哈,谢谢: https://docs.agora.io/cn/。当然,很感谢提出任何问题:-)


#11

【存在疑问】
onAudioVolumeIndication这里描述的是“提示频道内谁正在说话以及说话者音量的回调”。

在支持的过程中,发现大多用户对这里的音量理解是人声说话的音量,但实际测试发现,这里的音量应该是混音的音量,比如使用startAudioMixing在安静的环境下,也有较大的音量值返回。

https://docs.agora.io/cn/Interactive%20Broadcast/API%20Reference/java/classio_1_1agora_1_1rtc_1_1_i_rtc_engine_event_handler.html#a4d37f2b4d569fa787bb8c0e3ae8cd424
image


#12

1、请提供发现问题的文档链接
https://docs.agora.io/en/Voice/product_voice?platform=All%20Platforms

2、请指出哪里有问题
表述不准确,文中多次出现“The Agora Native SDK for Voice Call”。这个SDK包含Native和Web,将其统称为“The Agora Native SDK for Voice Call”可能不太恰当。

3、请提供你建议的修改方式
在以下链接中,将这个SDK的称呼改为了“The Agora Voice SDK”。这个称呼似乎更为恰当,建议在之前的链接中一并进行修改。
https://docs.agora.io/en/Voice/android_audio?platform=Android


#13

1、请提供发现问题的文档链接
https://docs.agora.io/en/Agora%20Platform/firewall

2、请指出哪里有问题
参照中文文档 https://docs.agora.io/cn/Agora%20Platform/firewall
Agora Web SDK 部分缺失代理服务器部分的注释。
Agora Signaling SDK 部分TCP端口与中文版不一致,白名单与中文版不一致。
Agora Gaming SDK 部分白名单与中文版不一致。

3、请提供你建议的修改方式
确保中文和英文文档相一致。


#15

文档地址:https://docs.agora.io/cn/Video/android_video?platform=Android

错误:


双引号为中文版双引号


#16

已修复:https://docs.agora.io/cn/Interactive%20Broadcast/android_video?platform=Android。


#17

pic

MIXING_INTERRUPTED_EOF 应该是播放是意外遇到EOF(End of File/End of Stream)错误提前结束


#18

麻烦提供下链接,谢谢


#19

image
rtm的快速开始iOS搜不到这个framework,我自测了一下也不需要这个framework


#20

https://docs.agora.io/cn/Interactive%20Broadcast/rawdata_ios_audio?platform=iOS

tip:

自采集音视频数据无法使用

onRecordAudioFrame

onRecordvideoFrame

{{}}

还有帮忙解释一下,裸数据回调都是什么意思。

采集前

播放器

渲染前
解释一下裸数据回调的几个回调都是什么意思,


#21


119的错误码是在何种时候产生,是不是给用户和我们自己一些提示,不然出现了之后用户不知道该忽略还是该退出房间。