Presentazione

La presentazione è il passaggio finale del processo UPnP. Se un dispositivo ha un URL per la presentazione, un punto di controllo può recuperare una pagina da questo URL e caricare la pagina in un browser. A seconda delle funzionalità della pagina di presentazione e del dispositivo, il punto di controllo può controllare il dispositivo e visualizzare lo stato del dispositivo.

Il percorso della risorsa, che viene passato a IUPnPRegistrar durante la registrazione, è dove si trovano tutti i file rilevanti per la presentazione del dispositivo. Gli sviluppatori di dispositivi possono fornire pagine separate per ogni dispositivo incorporato. L'URL della presentazione nel modello di descrizione del dispositivo può essere un URL assoluto o un URL relativo. Per gli URL relativi, relativi al percorso della risorsa, il modello di descrizione del dispositivo deve contenere un nome file. IUPnPRegistrar converte questo valore in un URL con la posizione effettiva. Per gli URL assoluti, la posizione non viene modificata.

Per supportare gli script lato client all'interno di una pagina di presentazione, le informazioni aggiuntive vengono in genere aggiunte all'URL sotto forma di "stringa di query". Le informazioni aggiuntive aggiunte sono l'URL del documento di descrizione del dispositivo e l'UDN del dispositivo o del dispositivo incorporato. L'URL della descrizione del dispositivo può essere usato per caricare un documento di descrizione nello script e quindi controllare il dispositivo tramite i relativi servizi. Il nome utente viene usato per selezionare un dispositivo incorporato dal dispositivo radice.

Il formato dell'URL della presentazione modificato è: l'URL di presentazione effettivo, un punto interrogativo ("?"), l'URL della descrizione del dispositivo, un segno più ("+"), il nome UDN del dispositivo. Il punto interrogativo indica l'inizio della stringa di query.

Se l'URL della presentazione nel modello di descrizione del dispositivo è un URL assoluto e contiene già un punto interrogativo ("?"), le informazioni aggiuntive non vengono aggiunte all'URL della presentazione.

Descrizione	URL
Nel modello di descrizione del dispositivo	presentationURLMyDevice.html**/presentationURL**
Generato dall'host del dispositivo	presentationURLhttps://machinename/deviceID/MyDevice.html/?https://machine/upnphost/udhisapi.dll?content=uuid:487394 ... + UDN**/presentationURL**

 

Uno script lato client potrebbe dover estrarre l'URL della descrizione del dispositivo dall'URL della presentazione per caricare l'oggetto IUPnPDescriptionDocument . Questa operazione viene eseguita prendendo la stringa di query e terminandola con il segno più ("+").

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)

Nel caso di una pagina di presentazione per un dispositivo incorporato, è necessario eseguire alcune operazioni aggiuntive. Dopo aver caricato UPnPDescriptionDocument, lo script deve ottenere la raccolta di dispositivi incorporati, quindi selezionare il dispositivo che corrisponde al nome utente nella stringa di query. Lo script seguente illustra come selezionare il dispositivo incorporato per la pagina di presentazione corrente. Presuppone che LightDesc sia già caricato.

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)