Представление

Презентация — это последний шаг процесса UPnP. Если у устройства есть URL-адрес для презентации, точка управления может получить страницу из этого URL-адреса и загрузить страницу в браузер. В зависимости от возможностей страницы презентации и устройства точка управления может управлять устройством и просматривать состояние устройства.

Путь к ресурсу, который передается в IUPnPRegistrar во время регистрации, находится все файлы, относящиеся к презентации устройства. Разработчики устройств могут предоставлять отдельные страницы для каждого внедренного устройства. URL-адрес презентации в шаблоне описания устройства может быть абсолютным URL-адресом или относительным URL-адресом. Для относительных URL-адресов, относящихся к пути к ресурсу, шаблон описания устройства должен содержать имя файла. IUPnPRegistrar преобразует это в URL-адрес с фактическим расположением. Для абсолютных URL-адресов расположение не изменяется.

Для поддержки клиентских скриптов на странице презентации дополнительные сведения обычно добавляются к URL-адресу в виде строки запроса. Дополнительные сведения, добавляемые, — это URL-адрес документа описания устройства, а также определяемый пользователем идентификатор устройства или внедренного устройства. URL-адрес описания устройства можно использовать для загрузки документа описания в скрипте, а затем управлять устройством с помощью служб. Определяемый пользователем идентификатор используется для выбора внедренного устройства из корневого устройства.

Формат измененного URL-адреса презентации: фактический URL-адрес презентации, вопросительный знак ("?"), URL-адрес описания устройства, знак плюса ("+"), определяемый пользователем устройства. Вопросительный знак обозначает начало строки запроса.

Если URL-адрес презентации в шаблоне описания устройства был абсолютным URL-адресом и он уже содержал вопросительный знак ("?"), то дополнительные сведения не добавляются в URL-адрес презентации.

Описание	URL-адрес
В шаблоне описания устройства	presentationURLMyDevice.html**/presentationURL**
Создается узлом устройства	presentationURLhttps://machinename/deviceID/MyDevice.html/?https://machine/upnphost/udhisapi.dll?content=uuid:487394... + UDN**/presentationURL**

 

Клиентский скрипт может потребоваться извлечь URL-адрес описания устройства из URL-адреса презентации, чтобы загрузить объект IUPnPDescriptionDocument. Это делается путем принятия строки запроса и завершения его в знаке плюса ("+").

Dim QueryString
QueryString = window.location.search
Dim DescURLString
DescURLString = Trim(Mid(QueryString,2,Instr(QueryString,"+")-2))& vbCrLf

    Dim LightDesc
    Set LightDesc = CreateObject("UPnP.DescriptionDocument.1")
    LightDesc.Load(DescURLString)

В случае страницы презентации для внедренного устройства требуется дополнительная работа. После загрузки UPnPDescriptionDocumentскрипт должен получить коллекцию внедренных устройств, а затем выбрать устройство, соответствующее UDN в строке запроса. В следующем сценарии показано, как выбрать внедренное устройство для текущей страницы презентации. Предполагается, что LightDesc уже загружен.

Dim LightDevice
Set LightDevice = LightDesc.RootDevice

Dim EmbeddedDevices 
set EmbeddedDevices = LightDevice.Children

Dim DeviceUdnString
DeviceUdnString = Trim(Mid(QueryString,Instr(QueryString,"+")+1,Len(QueryString)))

Dim Item
set Item = EmbeddedDevices.Item(DeviceUdnString)