Prezentacja

Prezentacja jest ostatnim krokiem procesu UPnP. Jeśli urządzenie ma adres URL prezentacji, punkt kontrolny może pobrać stronę z tego adresu URL i załadować stronę do przeglądarki. W zależności od możliwości strony prezentacji i urządzenia punkt kontrolny może kontrolować urządzenie i wyświetlać stan urządzenia.

Ścieżka zasobu, która jest przekazywana do IUPnPRegistrar podczas rejestracji, to miejsce, w którym znajdują się wszystkie pliki istotne dla prezentacji urządzenia. Deweloperzy urządzeń mogą udostępniać oddzielne strony dla każdego urządzenia osadzonego. Adres URL prezentacji w szablonie opisu urządzenia może być bezwzględnym adresem URL lub względnym adresem URL. W przypadku względnych adresów URL powiązanych ze ścieżką zasobu szablon opisu urządzenia powinien zawierać nazwę pliku. IUPnPRegistrar konwertuje to na adres URL z rzeczywistą lokalizacją. W przypadku bezwzględnych adresów URL lokalizacja nie jest modyfikowana.

Aby obsługiwać skrypty po stronie klienta na stronie prezentacji, dodatkowe informacje są zwykle dołączane do adresu URL w postaci "ciągu zapytania". Dodatkowe informacje, które są dołączane, to adres URL dokumentu opisu urządzenia oraz nazwa UDN urządzenia lub urządzenia osadzonego. Adres URL opisu urządzenia może służyć do załadowania dokumentu opisu w skrycie, a następnie kontrolowania urządzenia za pośrednictwem jego usług. Nazwa UDN służy do wybierania urządzenia osadzonego z urządzenia głównego.

Format zmodyfikowanej prezentacji URL to: rzeczywisty adres URL prezentacji, znak zapytania ("?"), adres URL opisu urządzenia, znak plus ("+"), nazwa UDN urządzenia. Znak zapytania oznacza początek ciągu zapytania.

Jeśli adres URL prezentacji w szablonie opisu urządzenia był bezwzględnym adresem URL i zawierał już znak zapytania ("?"), dodatkowe informacje nie są dodawane do adresu URL prezentacji.

Opis	Adres URL
W szablonie opisu urządzenia	prezentacjiURLMyDevice.html**/presentationURL**
Generowane przez hosta urządzenia	prezentacjiURLhttps://machinename/deviceID/MyDevice.html/?https://machine/upnphost/udhisapi.dll?content=uuid:487394... + UDN**/presentationURL**

 

Skrypt po stronie klienta może wymagać wyodrębnienia adresu URL opisu urządzenia z adresu URL prezentacji, aby załadować obiekt IUPnPDescriptionDocument. Jest to wykonywane przez pobranie ciągu zapytania i zakończenie go na znaku plus ("+").

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)

W przypadku strony prezentacji dla urządzenia osadzonego wymagana jest dodatkowa praca. Po załadowaniu UPnPDescriptionDocumentskrypt musi uzyskać kolekcję urządzeń osadzonych, a następnie wybrać urządzenie zgodne z nazwą UDN w ciągu zapytania. Poniższy skrypt przedstawia sposób wybierania urządzenia osadzonego dla bieżącej strony prezentacji. Przyjęto założenie, że lightDesc jest już załadowany.

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)