Apresentação

A apresentação é a etapa final do processo UPnP. Se um dispositivo tiver um URL para apresentação, um ponto de controle poderá recuperar uma página desse URL e carregá-la em um navegador. Dependendo das capacidades da página de apresentação e do dispositivo, o ponto de controle pode controlar o dispositivo e visualizar o status do dispositivo.

O caminho do recurso, que é passado para IUPnPRegistrar durante o registro, é onde todos os arquivos relevantes para a apresentação do dispositivo estão localizados. Os desenvolvedores de dispositivos podem fornecer páginas separadas para cada dispositivo incorporado. O URL de apresentação no modelo de descrição do dispositivo pode ser um URL absoluto ou um URL relativo. Para URLs relativas, que são relativas ao caminho do recurso, o modelo de descrição do dispositivo deve conter um nome de arquivo. IUPnPRegistrar converte isso em um URL com a localização real. Para URLs absolutos, o local não é modificado.

Para suportar scripts do lado do cliente dentro de uma página de apresentação, informações extras são normalmente acrescentadas à URL na forma de uma "cadeia de caracteres de consulta". As informações adicionais que são acrescentadas são a URL para o documento de descrição do dispositivo e a UDN do dispositivo ou dispositivo incorporado. O URL de descrição do dispositivo pode ser usado para carregar um documento de descrição no script e, em seguida, controlar o dispositivo através de seus serviços. A UDN é usada para selecionar um dispositivo incorporado a partir do dispositivo raiz.

O formato do URL de apresentação modificado é: o URL de apresentação real, um ponto de interrogação ("?"), o URL de descrição do dispositivo, um sinal de adição ("+"), o UDN do dispositivo. O ponto de interrogação indica o início da cadeia de caracteres de consulta.

Se o URL da apresentação no modelo de descrição do dispositivo for um URL absoluto e já contiver um ponto de interrogação ("?"), as informações adicionais não serão adicionadas ao URL da apresentação.

Descrição	URL
No modelo de descrição do dispositivo	presentationURLMyDevice.html**/presentationURL**
Gerado pelo host do dispositivo	presentationURLhttps://machinename/deviceID/MyDevice.html/?https://machine/upnphost/udhisapi.dll?content=uuid:487394... + UDN**/presentationURL**

 

Um script do lado do cliente pode ter que extrair a URL de descrição do dispositivo da URL da apresentação para carregar o objeto IUPnPDescriptionDocument. Isso é feito pegando a cadeia de caracteres de consulta e terminando-a no sinal de adição ("+").

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)

No caso de uma página de apresentação para um dispositivo incorporado, é necessário algum trabalho adicional. Depois de carregar o UPnPDescriptionDocument, o script deve obter a coleção de dispositivos incorporados e, em seguida, selecionar o dispositivo que corresponde ao UDN na cadeia de caracteres de consulta. O script a seguir mostra como selecionar o dispositivo incorporado para a página de apresentação atual. Ele assume que o LightDesc já está carregado.

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)