媒体服务直播活动错误代码
警告
Azure 媒体服务将于 2024 年 6 月 30 日停用。 有关详细信息，请参阅 AMS 停用指南。
下表列出了直播活动错误代码。
LiveEventConnectionRejected
订阅直播活动的事件网格事件时，可以从 LiveEventConnectionRejected 事件中看到以下错误之一。
| 错误 | 信息 |
|---|---|
| MPE_RTMP_APPID_AUTH_FAILURE | |
| 说明 | 引入 URL 不正确 |
| 建议的解决方案 | APPID 是 RTMP 引入 URL 中的 GUID 令牌。 请确保它与 API 中的引入 URL 相匹配。 |
| MPE_INGEST_ENCODER_CONNECTION_DENIED | |
| 说明 | 编码器 IP 在配置的 IP 允许列表中不存在 |
| 建议的解决方案 | 请确保编码器的 IP 位于 IP 允许列表中。 使用联机工具（如“whoismyip”或“CIDR 计算器”）设置正确的值。 请确保编码器可以在实际直播活动开始之前连接到服务器。 |
| MPE_INGEST_RTMP_SETDATAFRAME_NOT_RECEIVED | |
| 说明 | RTMP 编码器未发送 setDataFrame 命令。 |
| 建议的解决方案 | 多数商业编码器发送流元数据。 对于推送单比特率引入的编码器，这可能不是问题。 缺少流元数据时，LiveEvent 能够计算传入比特率。 对于 PassThru 通道或双重推送方案的多比特率引入，可以尝试在引入 URL 中追加含有“videodatarate”和“audiodatarate”的查询字符串。 近似值可能有效。 单位为 Kbit。 例如： rtmp://hostname:1935/live/GUID_APPID/streamname?videodatarate=5000&audiodatarate=192 |
| MPE_INGEST_CODEC_NOT_SUPPORTED | |
| 说明 | 不支持指定的编解码器。 |
| 建议的解决方案 | LiveEvent 收到不支持的编解码器。 例如，RTMP 引入时，LiveEvent 收到非 AVC 视频编解码器。 检查编码器预设。 |
| MPE_INGEST_DESCRIPTION_INFO_NOT_RECEIVED | |
| 说明 | 在实际媒体数据送达之前未收到媒体说明信息。 |
| 建议的解决方案 | LiveEvent 不会从编码器接收流说明（标头或 FLV 标记）。 这违反了协议。 联系编码器供应商。 |
| MPE_INGEST_MEDIA_QUALITIES_EXCEEDED | |
| 说明 | 音频或视频类型的质量级别计数超过了允许的最大限制。 超出限制的质量级别被服务忽略。 |
| 建议的解决方案 | 当直播活动处于“实时编码”模式时，编码器应推送单比特率的视频和音频。 请注意，系统允许使用同一比特率进行冗余推送。 检查编码器预设或输出设置，确保它输出的是单比特率流。 |
| MPE_INGEST_BITRATE_AGGREGATED_EXCEEDED | |
| 说明 | 直播活动或频道服务中的总传入比特率超过了允许的最大限制。 |
| 建议的解决方案 | 编码器超过了最大传入比特率。 此限制将聚合从参与编码器传入的所有数据。 检查编码器预设或输出设置，从而降低比特率。 |
| MPE_RTMP_FLV_TAG_TIMESTAMP_INVALID | |
| 说明 | 视频或音频 FLVTag 的时间戳在 RTMP 编码器中无效。 |
| 建议的解决方案 | 已弃用。 |
| MPE_INGEST_FRAMERATE_EXCEEDED | |
| 说明 | 传入的编码器引入流的帧速率超过了直播活动/频道编码的最大允许值，即 30 fps。 |
| 建议的解决方案 | 检查编码器预设，使帧速率降低至 36 fps 以下。 |
| MPE_INGEST_VIDEO_RESOLUTION_NOT_SUPPORTED | |
| 说明 | 传入的编码器引入流超过了以下允许的分辨率：1920x1088（直播活动/频道编码）和 4096x2160（基础和标准直接传递直播活动/频道编码）。 |
| 建议的解决方案 | 检查编码器预设，以降低视频分辨率，使其不超过限值。 |
| MPE_INGEST_RTMP_TOO_LARGE_UNPROCESSED_FLV | |
| 说明 | 直播活动同时接收了大量音频数据或大量没有任何关键帧的视频数据。 已断开编码器连接，允许它使用正确数据重试。 |
| 建议的解决方案 | 确保编码器为每个关键帧间隔 (GOP) 发送关键帧。 启用“恒定比特率 (CBR)”或“对齐关键帧”等设置。 有时，可尝试重置参与编码器。 如果不起作用，请联系编码器供应商。 |
LiveEventEncoderDisconnected
你可能会从 LiveEventEncoderDisconnected 事件中看到以下错误之一。
| 错误 | 信息 |
|---|---|
| MPE_RTMP_SESSION_IDLE_TIMEOUT | |
| 说明 | 在空闲时间达到允许的时间限制后，RTMP 会话超时。 |
| 建议的解决方案 | 当编码器停止接收输入源，导致无数据可推送，会话被闲置，此时通常会出现该错误。请注意检查编码器或输入源状态是否正常。 |
| MPE_RTMP_FLV_TAG_TIMESTAMP_INVALID | |
| 说明 | RTMP 编码器中视频或音频 FLVTag 的时间戳无效。 |
| 建议的解决方案 | 已弃用。 |
| MPE_CAPACITY_LIMIT_REACHED | |
| 说明 | 编码器发送数据的频率过快。 |
| 建议的解决方案 | 如果编码器在短时间内突发了大量片段，就会发生这种情况。 理论上，若编码器因网络问题暂时无法推送数据，而且在网络连通时产生了突发数据，就会发生这种情况。 从编码器日志或系统日志查找原因。 |
| 未知错误代码 | |
| 说明 | 这些错误代码的范围可能包括内存错误、哈希映射中包含重复条目，等等。 如果编码器在短时间内发送了大量片段，就会发生这种情况。 若编码器因网络问题暂时无法推送数据，并在网络连通时同时发送所有延迟片段，也可能会发生这种情况。 |
| 建议的解决方案 | 检查编码器日志。 |
其他错误代码
| 错误 | 信息 | 已拒绝/已断开连接活动 |
|---|---|---|
| ERROR_END_OF_MEDIA | 是 | |
| 说明 | 这属于常规错误。 | |
| 建议的解决方案 | 无。 | |
| MPI_SYSTEM_MAINTENANCE | 是 | |
| 说明 | 由于服务更新或系统维护，编码器已断开连接。 | |
| 建议的解决方案 | 请确保编码器启用了“自动连接”。 它允许编码器重新连接到未进行维护的冗余直播活动终结点。 | |
| MPE_BAD_URL_SYNTAX | 是 | |
| 说明 | 引入 URL 格式不正确。 | |
| 建议的解决方案 | 请确保引入 URL 格式正确。 对于 RTMP，它应该是 rtmp[s]://hostname:port/live/GUID_APPID/streamname |
|
| MPE_CLIENT_TERMINATED_SESSION | 是 | |
| 说明 | 编码器已断开会话连接。 | |
| 建议的解决方案 | 这不是错误。 编码器发起断开连接，包括不正常断开。 若此次是意外断开连接，请检查编码器日志。 | |
| MPE_INGEST_DISCONTINUITY | 否 | |
| 说明 | 传入数据不连续。 | |
| 建议的解决方案 | 这是一条警告消息，警示用户该编码器因网络问题或系统资源问题丢失了数据。 请检查编码器日志或系统日志。 并监视系统资源（CPU、内存或网络）。 如果系统 CPU 占用过高，请尝试降低比特率，或使用系统显卡中的 H/W 编码器选项。 |