使用Onvif Unity库连接Pelco PTZ摄像机遇400及认证错误

问题描述 #

我正在开发一款可远程控制PTZ摄像机的Unity应用，但建立连接时遇到以下问题：

• 使用Oneiros90的UnityOnvif库运行测试场景，客户端初始化无错，但调用mediaClient.GetProfiles()时抛出WebException: Status code 400(BadRequest)错误；
• 尝试直接用ONVIF核心代码连接，同样在调用GetProfiles()环节出现InvalidOperationException: 需通过ClientCredentials指定HTTP摘要认证用户名错误，尽管已配置认证信息；
• 相同逻辑在非Unity的C#项目中可正常运行，目标为Pelco品牌摄像机，怀疑存在兼容性问题。

附相关代码片段：

// UnityOnvif库使用代码示例
var client = new OnvifClient("http://camera-ip/onvif/device_service");
client.SetCredentials("username", "password");
try
{
    var profiles = client.MediaClient.GetProfiles(); // 此处抛出400错误
}
catch (WebException ex)
{
    Debug.LogError(ex.Message);
}

// 直接使用ONVIF核心代码示例
var mediaClient = new MediaClient(new BasicHttpBinding(), new EndpointAddress("http://camera-ip/onvif/media_service"));
mediaClient.ClientCredentials.HttpDigest.ClientCredential.UserName = "username";
mediaClient.ClientCredentials.HttpDigest.ClientCredential.Password = "password";
try
{
    var profiles = mediaClient.GetProfiles(); // 此处抛出认证错误
}
catch (InvalidOperationException ex)
{
    Debug.LogError(ex.Message);
}

可能的原因与解决方法 #

1. Unity Mono运行时的HTTP认证差异 #

Unity使用的Mono运行时在HTTP摘要认证的实现逻辑上，和标准.NET框架存在差异，无法正确适配ONVIF服务的认证流程。

解决方法：
手动构建HTTP请求并添加符合规范的认证头，替代库自带的客户端实现。示例使用UnityWebRequest处理：

IEnumerator GetCameraProfiles()
{
    string cameraMediaUrl = "http://camera-ip/onvif/media_service";
    string username = "your-username";
    string password = "your-password";

    // 构造GetProfiles的SOAP请求体
    string soapBody = @"<s:Envelope xmlns:s=""http://www.w3.org/2003/05/soap-envelope"" xmlns:trt=""http://www.onvif.org/ver10/media/wsdl"">
        <s:Header/>
        <s:Body>
            <trt:GetProfiles/>
        </s:Body>
    </s:Envelope>";

    UnityWebRequest request = UnityWebRequest.Post(cameraMediaUrl, "");
    request.uploadHandler = new UploadHandlerRaw(System.Text.Encoding.UTF8.GetBytes(soapBody));
    request.SetRequestHeader("Content-Type", "application/soap+xml; charset=utf-8");

    // 生成并添加HTTP摘要认证头（需自行实现GetDigestAuthHeader方法，遵循RFC 2617规范）
    string authHeader = GenerateDigestAuthHeader(cameraMediaUrl, username, password);
    request.SetRequestHeader("Authorization", authHeader);

    yield return request.SendWebRequest();

    if (request.result == UnityWebRequest.Result.Success)
    {
        Debug.Log("获取配置成功：" + request.downloadHandler.text);
    }
    else
    {
        Debug.LogError("请求失败：" + request.error);
    }
}

2. UnityOnvif库的适配问题 #

Oneiros90的UnityOnvif库可能未适配Pelco摄像机的ONVIF实现细节，比如SOAP命名空间、请求格式或认证流程的特殊要求。

解决方法：

• 对比非Unity项目的请求日志，查看两者的SOAP请求体、请求头差异，修改库中对应的请求构造逻辑；
• 检查库源码中认证信息的传递流程，确认SetCredentials方法是否正确将用户名密码注入到HTTP请求头中，必要时手动修改库的认证实现代码。

3. 服务端点地址错误 #

Pelco摄像机的ONVIF服务路径可能与标准路径不同，导致请求地址无效返回400错误。

解决方法：

• 通过ONVIF设备发现协议获取摄像机的真实服务端点：使用DeviceDiscovery类扫描局域网内的ONVIF设备，获取其media服务的正确地址；
• 登录摄像机的Web管理界面，查看ONVIF服务的WSDL文档，确认media服务的端点地址是否与代码中使用的一致。

内容的提问来源于stack exchange，提问作者thielmlw