PHP управление Onvif-совместимой купольной IP камерой RVI/Dahua

      11 комментариев к записи PHP управление Onvif-совместимой купольной IP камерой RVI/Dahua

Недавно появилась необходимость собирать скриншоты с нескольких управляемых PTZ купольных IP камер RVi-IPC52DN20‎.

Стандарт Onvif подразумевает взаимодействие с устройством через SOAP интерфейс.

Получаем информацию об устройстве

Согласно официальной спецификации, на запрос GetDeviceInformation:

[xml]<s:Envelope xmlns:s="http://www.w3.org/2003/05/soap-envelope">
<s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<GetDeviceInformation xmlns="http://www.onvif.org/ver10/device/wsdl"/>
</s:Body>
</s:Envelope>[/xml]

Устройство отвечает:

[xml]<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://www.w3.org/2003/05/soap-envelope"
xmlns:SOAP-ENC="http://www.w3.org/2003/05/soap-encoding"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:wsa5="http://www.w3.org/2005/08/addressing"
xmlns:c14n="http://www.w3.org/2001/10/xml-exc-c14n#"
xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"
xmlns:xenc="http://www.w3.org/2001/04/xmlenc#"
xmlns:ds="http://www.w3.org/2000/09/xmldsig#"
xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"
xmlns:xmime5="http://www.w3.org/2005/05/xmlmime"
xmlns:xmime="http://tempuri.org/xmime.xsd"
xmlns:xop="http://www.w3.org/2004/08/xop/include"
xmlns:ns1="http://www.placeholder.org/ver10/tmp/schema"
xmlns:scdl="http://www.placeholder.org/ver10/scdl/schema"
xmlns:tt="http://www.onvif.org/ver10/schema"
xmlns:wsrf-bf="http://docs.oasis-open.org/wsrf/bf-2"
xmlns:wstop="http://docs.oasis-open.org/wsn/t-1"
xmlns:wsrf-r="http://docs.oasis-open.org/wsrf/r-2"
xmlns:scws="http://www.placeholder.org/ver10/scdl/wsdl"
xmlns:ns2="http://www.placeholder.org/ver10/tmp/wsdl"
xmlns:tae="http://www.onvif.org/ver10/actionengine/wsdl"
xmlns:tan0="http://www.onvif.org/ver20/analytics/wsdl/RuleEngineBinding"
xmlns:tan1="http://www.onvif.org/ver20/analytics/wsdl/AnalyticsEngineBinding"
xmlns:tan="http://www.onvif.org/ver20/analytics/wsdl"
xmlns:tds="http://www.onvif.org/ver10/device/wsdl"
xmlns:tev0="http://www.onvif.org/ver10/events/wsdl/PullPointSubscriptionBinding"
xmlns:tev1="http://www.onvif.org/ver10/events/wsdl/EventBinding"
xmlns:tev="http://www.onvif.org/ver10/events/wsdl"
xmlns:tev2="http://www.onvif.org/ver10/events/wsdl/SubscriptionManagerBinding"
xmlns:tev3="http://www.onvif.org/ver10/events/wsdl/NotificationProducerBinding"
xmlns:tev4="http://www.onvif.org/ver10/events/wsdl/NotificationConsumerBinding"
xmlns:tev5="http://www.onvif.org/ver10/events/wsdl/PullPointBinding"
xmlns:tev6="http://www.onvif.org/ver10/events/wsdl/CreatePullPointBinding"
xmlns:ter="http://www.onvif.org/ver10/error"
xmlns:tns1="http://www.onvif.org/ver10/topics"
xmlns:tev7="http://www.onvif.org/ver10/events/wsdl/PausableSubscriptionManagerBinding"
xmlns:wsnt="http://docs.oasis-open.org/wsn/b-2"
xmlns:timg="http://www.onvif.org/ver20/imaging/wsdl"
xmlns:tmd="http://www.onvif.org/ver10/deviceIO/wsdl"
xmlns:tptz="http://www.onvif.org/ver20/ptz/wsdl"
xmlns:trt="http://www.onvif.org/ver10/media/wsdl">
<SOAP-ENV:Body>
<tds:GetDeviceInformationResponse>
<tds:Manufacturer>Group</tds:Manufacturer>
<tds:Model>RVI-IPC52DN20</tds:Model>
<tds:FirmwareVersion>2.103.Group 00.0.T, build: 2013-08-22(V4.1.1)</tds:FirmwareVersion>
<tds:SerialNumber>TZB3EN00900005</tds:SerialNumber>
<tds:HardwareId>1.00</tds:HardwareId>
</tds:GetDeviceInformationResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
[/xml]

Управление PanTiltZoom

Через веб-интерфейс, как и протокол Onvif, можно задать контрольные точки (Presets) положения/зума камеры и алгоритмы автоматического их обхода в нужной последовательности. Обратимся к соответствующему разделу спецификации.  Команда GotoPreset принимает параметрами ProfileToken и PresetToken (необязательный Speed мы опустим). Ориентируем камеру на точку 2:

[xml]<s:Envelope xmlns:s="http://www.w3.org/2003/05/soap-envelope">
<s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<GotoPreset xmlns="http://www.onvif.org/ver20/ptz/wsdl">
<ProfileToken>0000</ProfileToken>
<PresetToken>2</PresetToken>
</GotoPreset>
</s:Body>
</s:Envelope>[/xml]

Ответ устройства:

[xml]<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://www.w3.org/2003/05/soap-envelope"
xmlns:SOAP-ENC="http://www.w3.org/2003/05/soap-encoding"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:wsa5="http://www.w3.org/2005/08/addressing"
xmlns:c14n="http://www.w3.org/2001/10/xml-exc-c14n#"
xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"
xmlns:xenc="http://www.w3.org/2001/04/xmlenc#" xmlns:ds="http://www.w3.org/2000/09/xmldsig#"
xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"
xmlns:xmime5="http://www.w3.org/2005/05/xmlmime"
xmlns:xmime="http://tempuri.org/xmime.xsd"
xmlns:xop="http://www.w3.org/2004/08/xop/include"
xmlns:ns1="http://www.placeholder.org/ver10/tmp/schema"
xmlns:scdl="http://www.placeholder.org/ver10/scdl/schema"
xmlns:tt="http://www.onvif.org/ver10/schema" xmlns:wsrf-bf="http://docs.oasis-open.org/wsrf/bf-2"
xmlns:wstop="http://docs.oasis-open.org/wsn/t-1"
xmlns:wsrf-r="http://docs.oasis-open.org/wsrf/r-2"
xmlns:scws="http://www.placeholder.org/ver10/scdl/wsdl"
xmlns:ns2="http://www.placeholder.org/ver10/tmp/wsdl"
xmlns:tae="http://www.onvif.org/ver10/actionengine/wsdl"
xmlns:tan0="http://www.onvif.org/ver20/analytics/wsdl/RuleEngineBinding"
xmlns:tan1="http://www.onvif.org/ver20/analytics/wsdl/AnalyticsEngineBinding"
xmlns:tan="http://www.onvif.org/ver20/analytics/wsdl"
xmlns:tds="http://www.onvif.org/ver10/device/wsdl"
xmlns:tev0="http://www.onvif.org/ver10/events/wsdl/PullPointSubscriptionBinding"
xmlns:tev1="http://www.onvif.org/ver10/events/wsdl/EventBinding"
xmlns:tev="http://www.onvif.org/ver10/events/wsdl"
xmlns:tev2="http://www.onvif.org/ver10/events/wsdl/SubscriptionManagerBinding"
xmlns:tev3="http://www.onvif.org/ver10/events/wsdl/NotificationProducerBinding"
xmlns:tev4="http://www.onvif.org/ver10/events/wsdl/NotificationConsumerBinding"
xmlns:tev5="http://www.onvif.org/ver10/events/wsdl/PullPointBinding"
xmlns:tev6="http://www.onvif.org/ver10/events/wsdl/CreatePullPointBinding"
xmlns:ter="http://www.onvif.org/ver10/error"
xmlns:tns1="http://www.onvif.org/ver10/topics"
xmlns:tev7="http://www.onvif.org/ver10/events/wsdl/PausableSubscriptionManagerBinding"
xmlns:wsnt="http://docs.oasis-open.org/wsn/b-2"
xmlns:timg="http://www.onvif.org/ver20/imaging/wsdl"
xmlns:tmd="http://www.onvif.org/ver10/deviceIO/wsdl"
xmlns:tptz="http://www.onvif.org/ver20/ptz/wsdl"
xmlns:trt="http://www.onvif.org/ver10/media/wsdl">
<SOAP-ENV:Body>
<tptz:GotoPresetResponse></tptz:GotoPresetResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>[/xml]

Реализация управления на php

Обертка. Посылаем запрос с командой по адресу http://HOSTNAME/onvif/ptz_service:

function ptzMove($ipaddress,$preset)
{
    $post_string = '<s:Envelope xmlns:s="http://www.w3.org/2003/05/soap-envelope">'
            . '<s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">'
            . '<GotoPreset xmlns="http://www.onvif.org/ver20/ptz/wsdl">'
            . '<ProfileToken>0000</ProfileToken>'
            . '<PresetToken>' . $preset . '</PresetToken>'
            . '</GotoPreset></s:Body></s:Envelope>';
    $mediauri='http://'.$ipaddress.'/onvif/ptz_service';
    $response = sendRequest($mediauri,$post_string);
}

Пара рабочих лошадок. При помощи curl посылаем SOAP запрос, проверяем на ошибки и конвертируем ответ в php массив:

function sendRequest($url,$post_string) {
    $soap_do = curl_init();
    curl_setopt($soap_do, CURLOPT_URL,            $url );
    curl_setopt($soap_do, CURLOPT_CONNECTTIMEOUT, 10);
    curl_setopt($soap_do, CURLOPT_TIMEOUT,        10);
    curl_setopt($soap_do, CURLOPT_RETURNTRANSFER, true );
    curl_setopt($soap_do, CURLOPT_SSL_VERIFYPEER, false);
    curl_setopt($soap_do, CURLOPT_SSL_VERIFYHOST, false);
    curl_setopt($soap_do, CURLOPT_POST,           true );
    curl_setopt($soap_do, CURLOPT_POSTFIELDS,    $post_string);
    curl_setopt($soap_do, CURLOPT_HTTPHEADER,     [
        'Content-Type: text/xml; charset=utf-8',
        'Content-Length: '.strlen($post_string),
    ]);
    //curl_setopt($soap_do, CURLOPT_USERPWD, $user . ":" . $password); // HTTP authentication
    if ( ($result = curl_exec($soap_do)) === false) {
            $err = curl_error($soap_do);
            $lastresponse = [ "Fault" => $err];
    } else {
            $lastresponse=_xml2array($result);
    }
    return $lastresponse;
}

function _xml2array($response) {
    $sxe = new SimpleXMLElement($response);
    $dom_sxe = dom_import_simplexml($sxe);
    $dom = new DOMDocument('1.0');
    $dom_sxe = $dom->importNode($dom_sxe, true);
    $dom_sxe = $dom->appendChild($dom_sxe);
    $element = $dom->childNodes->item(0);
    foreach ($sxe->getDocNamespaces() as $name => $uri) {
            $element->removeAttributeNS($uri, $name);
    }
    $xmldata=$dom->saveXML();
    $xmldata=substr($xmldata,strpos($xmldata,"<Envelope>"));
    $xmldata=substr($xmldata,0,strpos($xmldata,"</Envelope>")+strlen("</Envelope>"));
    $xml=simplexml_load_string($xmldata);
    $data=json_decode(json_encode((array)$xml),1);
    $data=array($xml->getName()=>$data);
    return $data;
}

После установки камеры в нужную точку скриншот с нее можно получить по адресу http://HOSTNAME/cgi-bin/snapshot.cgi?channel=0 любыми подручными способами.

Лошадки взяты у Lorenzo Toscano. Так же очень помог проект Менеджер устройств ONVIF.

11 thoughts on “PHP управление Onvif-совместимой купольной IP камерой RVI/Dahua”

  1. Олег

    Добрый день.
    А можно подробнее как полностью реализовать запрос к камере?
    Т.е. у меня установлен апач, я создаю простенький скрипт на пхп, основываясь на Ваших функциях, а вот сам момент запуска скрипта и топология запроса не совсем понятна…
    Спасибо а ответ.

    Ответить ↓
    1. nix Автор записи

      В простейшем случае апач не нужен, только php.
      Минимальный скрипт:

      require 'lib/class.ponvif.php';
      $test = new ponvif();
      $test->setUsername('username');
      $test->setPassword('password');
      $test->setIPAddress('192.168.1.100');
      $test->initialize();
      print_r($test->media_GetVideoSources());

      Ответить ↓
  2. Олег

    Понял, в библиотеке есть все методы, мы просто ими пользуемся.
    Спасибо за ответ!

    Ответить ↓
  5. Олег

    Извиняюсь за кучу сообщений. Но мне актуальна данная тема.
    Библиотека, про которую я писал немного скудна. Ваша обширней по возможностям.
    Но что касается PTZ у меня заработало только ptz_ContinuousMove(), наверное, особенности моих камер.

    Ответить ↓
  6. nix Автор записи

    Проверьте актуальность прошивки. Если заявлен Onvif, должно работать)

    Ответить ↓
  7. Олег

    Результат выполнения getSupportedVersion():

    Array ( [major] => 2 [minor] => 0 )

    Как я понял ver. 20

    Буду пробовать дальше

    Ответить ↓
  8. Олег

    Добрый день.
    Извиняюсь за беспокойство, но таки не получилось реализовать PTZ сдвиг на «шаг», т.е. только постоянное вращение.
    Как я понял позднее, мои камеры работают с ONVIF 10.
    Библиотеки на php шустро подключаются к камерам, делают базовые функции, но с PTZ: 0 эмоций.
    Можете ли Вы мне что-то посоветовать?
    Возможно взять xml запросы из документации к версии 10, но пока не представляю как это реализовать в коде.

    Спасибо за ответы.

    Ответить ↓
  9. Олег

    Добрый день.
    До сих пор бьюсь с onvif на php. Не могу не двинуть ptz на один шаг, не получить снапшот.
    Реализовал функции кадрирования и записи rstp потока в avi, используя openCV на СИ. Начал изучать onvifcpplib на С++.
    Как же на чистом php получить кадр или поток с камеры, как двинуть камерой? Может, есть методы html5 для вставки потока и управления ptz?
    Спасибо.

    Ответить ↓

Добавить комментарий

Ваш адрес email не будет опубликован. Обязательные поля помечены *