Präsentation

Die Präsentation ist der letzte Schritt im UPnP-Prozess. Wenn ein Gerät über eine URL für die Präsentation verfügt, kann ein Kontrollpunkt eine Seite von dieser URL abrufen und die Seite in einen Browser laden. Abhängig von den Funktionen der Präsentationsseite und des Geräts kann der Kontrollpunkt das Gerät steuern und den Status des Geräts anzeigen.

Der Ressourcenpfad, der während der Registrierung an IUPnPRegistrar übergeben wird, ist der Ort, an dem sich alle für die Präsentation des Geräts relevanten Dateien befinden. Geräteentwickler können separate Seiten für jedes eingebettete Gerät bereitstellen. Die Präsentations-URL in der Gerätebeschreibungsvorlage kann entweder eine absolute URL oder eine relative URL sein. Bei relativen URLs, die relativ zum Ressourcenpfad sind, sollte die Gerätebeschreibungsvorlage einen Dateinamen enthalten. IUPnPRegistrar diese in eine URL mit dem tatsächlichen Speicherort konvertiert. Bei absoluten URLs wird der Speicherort nicht geändert.

Um clientseitige Skripts auf einer Präsentationsseite zu unterstützen, werden normalerweise zusätzliche Informationen in Form einer "Abfragezeichenfolge" an die URL angefügt. Die zusätzlichen Informationen, die angefügt werden, sind die URL des Gerätebeschreibungsdokuments und der UDN des Geräts oder eingebetteten Geräts. Die Gerätebeschreibungs-URL kann verwendet werden, um ein Beschreibungsdokument im Skript zu laden und dann das Gerät über seine Dienste zu steuern. Der UDN wird verwendet, um ein eingebettetes Gerät vom Stammgerät auszuwählen.

Das Format der geänderten Präsentations-URL lautet: die tatsächliche Präsentations-URL, ein Fragezeichen ("?"), die Gerätebeschreibungs-URL, ein Pluszeichen ("+"), das Geräte-UDN. Das Fragezeichen zeigt den Anfang der Abfragezeichenfolge an.

Wenn die Präsentations-URL in der Gerätebeschreibungsvorlage eine absolute URL war und bereits ein Fragezeichen ("?") enthielt, werden die zusätzlichen Informationen nicht zur Präsentations-URL hinzugefügt.

Beschreibung	URL
In der Gerätebeschreibungsvorlage	presentationURLMyDevice.html**/presentationURL**
Vom Gerätehost generiert	presentationURLhttps://machinename/deviceID/MyDevice.html/?https://machine/upnphost/udhisapi.dll?content=uuid:487394... + UDN**/presentationURL**

 

Ein clientseitiges Skript muss möglicherweise die Gerätebeschreibungs-URL aus der Präsentations-URL extrahieren, um das IUPnPDescriptionDocument--Objekt zu laden. Dazu wird die Abfragezeichenfolge verwendet und am Pluszeichen ("+") beendet.

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)

Bei einer Präsentationsseite für ein eingebettetes Gerät sind einige zusätzliche Aufgaben erforderlich. Nach dem Laden des UPnPDescriptionDocument-muss das Skript die Sammlung eingebetteter Geräte abrufen und dann das Gerät auswählen, das dem UDN in der Abfragezeichenfolge entspricht. Das folgende Skript zeigt, wie Sie das eingebettete Gerät für die aktuelle Präsentationsseite auswählen. Es wird davon ausgegangen, dass LightDesc bereits geladen ist.

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)