Modello concettuale

Questa sezione descrive gli oggetti, le proprietà e le risorse che costituiscono il modello concettuale WPD.

Oggetti

In WPD le entità logiche nei dispositivi vengono definite oggetti. In genere, ma non sempre, questi rappresentano i dati nel dispositivo. Gli oggetti hanno proprietà e vengono a cui fa riferimento gli identificatori di oggetto. Esempi di oggetti includono immagini e cartelle su una fotocamera, canzoni e playlist su un lettore multimediale, contatti su un telefono cellulare e così via.

Gli oggetti possono anche rappresentare parti funzionali o informativi del dispositivo. Esempi di questi includono i controlli lettore (play/record/pause), le impostazioni della fotocamera, le funzionalità SMS di un telefono cellulare e così via.

I due argomenti seguenti forniscono esempi e illustrazioni di due tipi di oggetti: l'oggetto Image e l'oggetto Mediacast.

Oggetto Image

Un oggetto image rappresenta un'immagine ancora. Il diagramma seguente illustra le relazioni tra un oggetto Image, le relative proprietà e le relative risorse.

Per altre informazioni sull'oggetto Image e sulle relative proprietà, vedere l'argomento WPD_CONTENT_TYPE_IMAGE .

Oggetto Mediacast

Un oggetto Mediacast può essere considerato come un oggetto contenitore che raggruppa contenuto correlato, proprio come musica per i gruppi di playlist. Spesso, un oggetto Mediacast viene usato per raggruppare contenuti multimediali pubblicati online. Ad esempio, un canale RSS può essere rappresentato come oggetto Mediacast i cui riferimenti all'oggetto puntano a oggetti contenuto che rappresentano ogni elemento del canale. Il diagramma seguente illustra la relazione tra un oggetto Mediacast e i tre oggetti audio contenuti.

I riferimenti all'oggetto audio vengono specificati nella proprietà WPD_OBJECT_REFERENCES per l'oggetto Mediacast. Per altre informazioni sulle proprietà supportate da un oggetto Mediacast, vedere l'argomento WPD_CONTENT_TYPE_MEDIA_CAST .

Proprietà

Le proprietà dell'oggetto forniscono un meccanismo per lo scambio di metadati che descrivono gli oggetti. Ad esempio, un oggetto image può includere proprietà che descrivono il nome del file, le dimensioni, il formato, la larghezza in pixel e così via.

Le proprietà hanno un valore corrente, nonché attributi. WPD definisce un set di proprietà standard che costituiscono le definizioni API e DDI. I fornitori non sono limitati alle proprietà WPD predefinite e sono liberi di aggiungere i propri.

Attributi di proprietà

Gli attributi delle proprietà descrivono i diritti di accesso, i valori validi e altre informazioni correlate a una proprietà. Ad esempio, la proprietà che rappresenta la velocità di bit può essere un intervallo compreso tra 8 kilobit al secondo (Kbps) e 20 Kbps con un valore di passaggio pari a 1 Kbps.

I diritti di accesso indicano se i chiamanti possono leggere, scrivere ed eliminare la proprietà. I valori validi indicano restrizioni per i valori delle proprietà. I valori validi devono essere di un modulo specifico. I moduli valore validi includono Range (ovvero la proprietà può accettare un valore da Min a Max con passaggio specificato), enumerazione (ovvero, il valore della proprietà è uno di quelli nell'elenco specificato) e Nessuno (ovvero non sono presenti valori validi specifici).

Risorse

Le risorse sono segnaposto per i dati binari. Un oggetto può avere più di una risorsa. Ad esempio, se l'oggetto ha rappresentato un file di immagine con un'annotazione audio, le risorse per questo oggetto potrebbero essere le seguenti:

• Risorsa predefinita. Questa risorsa rappresenta l'intero file di immagine. Questo include tutti i dati incorporati, ad esempio annotazioni audio, anteprime e così via)
• Risorsa di anteprima. Questa risorsa rappresenta i dati di anteprima per l'immagine.
• Risorsa di annotazione audio. Questa risorsa rappresenta i dati audio associati all'immagine.

Attributi delle risorse

Analogamente agli attributi delle proprietà, gli attributi delle risorse descrivono i diritti di accesso, le dimensioni, il formato e altre informazioni correlate a una risorsa. Ad esempio, gli attributi per una risorsa di annotazione audio in un oggetto immagine possono specificare la frequenza di bit, il conteggio dei canali e il formato dati dell'audio.

Profili di rendering e attributi delle risorse

Il profilo di rendering è un metodo usato dalle applicazioni per individuare gli attributi validi per una determinata risorsa. Ad esempio, un telefono cellulare può supportare bitmap con restrizioni specifiche sui valori minimo e massimo di larghezza e altezza. Eseguendo una query sui profili di rendering per l'oggetto bitmap, un'applicazione può recuperare tali valori esatti.

L'output di esempio seguente identifica le informazioni sul profilo di rendering restituite dal dispositivo se supporta le bitmap con un'altezza minima di 10 pixel, una larghezza minima di 20 pixel, un'altezza massima di 1000 pixel e una larghezza massima di 2000 pixel.

WPD_OBJECT_FORMAT = WPD_OBJECT_FORMAT_BMP
WPD_MEDIA_HEIGHT:
        WPD_PROPERTY_ATTRIBUTE_FORM = WPD_PROPERTY_ATTRIBUTE_FORM_RANGE
        WPD_PROPERTY_ATTRIBUTE_DEFAULT_VALUE =  10
        WPD_PROPERTY_ATTRIBUTE_RANGE_MIN =  10 
        WPD_PROPERTY_ATTRIBUTE_RANGE_MAX = 1000
        WPD_PROPERTY_ATTRIBUTE_RANGE_STEP = 1
WPD_MEDIA_WIDTH:
        WPD_PROPERTY_ATTRIBUTE_FORM = WPD_PROPERTY_ATTRIBUTE_FORM_RANGE
        WPD_PROPERTY_ATTRIBUTE_DEFAULT_VALUE =  20 
        WPD_PROPERTY_ATTRIBUTE_RANGE_MIN =  20 
        WPD_PROPERTY_ATTRIBUTE_RANGE_MAX =  2000
        WPD_PROPERTY_ATTRIBUTE_RANGE_STEP = 1
WPD_RESOURCE_ATTRIBUTE_TOTAL_SIZE:
        WPD_PROPERTY_ATTRIBUTE_FORM = WPD_PROPERTY_ATTRIBUTE_FORM_RANGE
        WPD_PROPERTY_ATTRIBUTE_DEFAULT_VALUE = 0
        WPD_PROPERTY_ATTRIBUTE_RANGE_MIN =  2000 
        WPD_PROPERTY_ATTRIBUTE_RANGE_MAX = 1000000
        WPD_PROPERTY_ATTRIBUTE_RANGE_STEP = 1

Vedere l'argomento Recupero delle funzionalità di rendering supportate da un argomento Device nella guida alla programmazione per una descrizione del modo in cui l'applicazione può recuperare un profilo di rendering (e gli attributi di risorsa associati).

Argomenti correlati

Panoramica dell'applicazione