Уровень представления

Презентация является последним шагом в процессе 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)