阿里云直播审核无官方PHP SDK,需手写HTTP请求调用OpenAPI;video_url必须为阿里云直播RTMP/HTTP-FLV地址并开启AI审核;语音检测依赖视频流自动提取AAC音频;回调须公网HTTPS且校验签名。

阿里云AI直播审核SDK在PHP中无法初始化 client
直接用官方 PHP SDK 初始化 AlibabaCloud\Tea\Console\Client 或 V20240115\Client 会报错,因为阿里云目前**没有发布正式支持直播审核场景的 PHP SDK**。所有文档里提到的 V20240115(对应 liveaudit 服务)仅提供 OpenAPI 规范,不带 PHP 封装类。
实操建议:
- 放弃找现成
LiveAuditClient类,它不存在;必须手写 HTTP 请求调用 OpenAPI - 使用
cURL或GuzzleHttp\Client发送 POST 请求到https://liveaudit.cn-shanghai.aliyuncs.com - 签名必须用
AK/SK+SHA256withRSA签名方式,不能用简单 access_token - Header 中必须包含
x-acs-signature-nonce、x-acs-signature-method、x-acs-version、x-acs-action等字段,漏一个就返回InvalidAccessKeyId.NotFound
PHP 实时推流画面检测:如何构造合规的 video_url 参数
直播审核接口要求传入的 video_url 不是本地文件路径,也不是任意公网 URL,而是阿里云内部可拉取的流地址 —— 必须是已接入阿里云视频直播服务(ApsaraVideo Live)的 rtmp:// 或 http-flv:// 地址,且需开启「录制」或「AI 审核」功能。
常见错误现象:
立即学习“PHP免费学习笔记(深入)”;
- 传
https://your-domain.com/live/test.flv→ 返回InvalidParameter.VideoUrl - 传本地
file:///tmp/stream.mp4→ 直接 400,服务端根本不会尝试读取 - 用非阿里云 CDN 的 FLV 地址 → 超时,因审核服务只信任自家边缘节点
正确做法:
- 确保流已推送到阿里云直播域名,如
rtmp://xxx.live.aliyuncs.com/app/stream - 在控制台为该流开启「AI 内容审核」开关(路径:视频直播 → 域名管理 → 对应域名 → AI 审核)
-
video_url字段填http-flv://xxx.live.aliyuncs.com/app/stream(注意协议和域名一致)
语音违规识别失败:PHP 提交 audio_url 后始终返回 empty result
语音审核不是独立接口,它依赖画面审核任务中自动提取的音频轨 —— 你不能单独提交一段 MP3 给直播审核 API。所谓 audio_url 参数,仅在「点播审核」场景下有效,而直播审核的语音检测是后台自动做的,无需也不允许手动指定音频源。
所以如果你看到返回里 "audio_result": [] 或缺失字段,大概率是因为:
- 推流未开启音频编码(如只推纯视频流),导致无音频轨可分析
- 音频编码格式非
AAC(阿里云只支持 AAC-LC,不支持 Opus/MP3/PCM) - 流延迟过高(>8s),触发了音频截断策略,审核服务跳过语音部分
验证方法:用 ffprobe 检查流信息:ffprobe -v quiet -show_entries stream=codec_type,codec_name -of default rtsp://xxx,确认有 codec_type=audio 且 codec_name=aac
PHP 处理回调通知时收不到 audit_result
阿里云直播审核结果不是同步返回的,必须配置 HTTPS 回调地址,且该地址要能被阿里云外网访问。很多人本地开发时填 http://localhost:8000/callback,自然收不到任何数据。
关键条件:
- 回调地址必须是公网可访问的 HTTPS 域名(自签名证书不行,需 Let's Encrypt 或商业 CA)
- PHP 接口必须响应
200 OK,且 body 为空(不能输出任何字符,包括 BOM、空格、echo "") - 收到的 POST 数据是 raw JSON,不是
$_POST,要用file_get_contents("php://input")读取 - 必须校验
X-Acs-SignatureHeader,否则可能是伪造请求(签名密钥 = AK + SK + timestamp 拼接后 SHA256)
示例校验片段(简化):
if (!isset($_SERVER['HTTP_X_ACS_SIGNATURE'])) {
http_response_code(400);
exit;
}
$rawBody = file_get_contents('php://input');
$expected = hash_hmac('sha256', $rawBody . $_SERVER['HTTP_X_ACS_TIMESTAMP'], $accessKeySecret);
if (!hash_equals($expected, $_SERVER['HTTP_X_ACS_SIGNATURE'])) {
http_response_code(401);
exit;
}
事情说清了就结束。最常卡住的地方其实是签名生成和回调地址的 HTTPS 有效性——这两个点没调通,后面全白搭。



















