Modelo conceptual

En esta sección se describen los objetos, las propiedades y los recursos que constituyen el modelo conceptual de WPD.

Objetos

En WPD, las entidades lógicas de los dispositivos se conocen como objetos . Normalmente, pero no siempre, estos representan datos en el dispositivo. Los objetos tienen propiedades y los identificadores de objeto hacen referencia a ellos. Algunos ejemplos de objetos incluyen imágenes y carpetas en una cámara, canciones y listas de reproducción en un reproductor multimedia, contactos en un teléfono móvil, etc.

Los objetos también pueden representar partes funcionales o informativas del dispositivo. Algunos ejemplos de estos son los controles del reproductor (reproducir, grabar o pausar), la configuración de la cámara, las funcionalidades de SMS de un teléfono móvil, etc.

En los dos temas siguientes se proporcionan ejemplos e ilustraciones de dos tipos de objetos: el objeto Image y el objeto Mediacast.

Image (objeto)

Un objeto image representa una imagen fija. En el diagrama siguiente se muestran las relaciones entre un objeto Image, sus propiedades y sus recursos.

Para obtener más información sobre el objeto Image y sus propiedades, vea el tema WPD_CONTENT_TYPE_IMAGE .

Objeto Mediacast

Un objeto Mediacast se puede considerar como un objeto contenedor que agrupa contenido relacionado, al igual que una lista de reproducción agrupa música. A menudo, un objeto Mediacast se usa para agrupar contenido multimedia publicado en línea. Por ejemplo, un canal RSS se puede representar como un objeto Mediacast cuyo objeto hace referencia a objetos de contenido que representan cada elemento del canal. En el diagrama siguiente se muestra la relación entre un objeto Mediacast y los tres objetos de audio que contiene.

Las referencias al objeto de audio se especifican en la propiedad WPD_OBJECT_REFERENCES para el objeto Mediacast. Para obtener más información sobre las propiedades admitidas por un objeto Mediacast, vea el tema WPD_CONTENT_TYPE_MEDIA_CAST .

Propiedades

Las propiedades del objeto proporcionan un mecanismo para intercambiar metadatos que describen objetos. Por ejemplo, un objeto de imagen puede incluir propiedades que describen su nombre de archivo, tamaño, formato, ancho en píxeles, etc.

Las propiedades tienen un valor actual, así como atributos. WPD define un conjunto de propiedades estándar que componen las definiciones de API y DDI. Los proveedores no están limitados a las propiedades predefinidas de WPD y son libres de agregar sus propios.

Atributos de propiedad

Los atributos de propiedad describen los derechos de acceso, los valores válidos y otra información relacionada con una propiedad. Por ejemplo, la propiedad que representa la velocidad de bits podría ser un intervalo de 8 kilobits por segundo (Kbps) a 20 Kbps con un valor de paso de 1 Kbps.

Los derechos de acceso indican si los autores de llamadas pueden leer, escribir o eliminar la propiedad . Los valores válidos indican restricciones para los valores de propiedad. Se dice que los valores válidos son de un formulario específico. Los formularios de valor válidos incluyen Range (es decir, la propiedad puede tomar un valor de Min a Max con el paso especificado), Enumeración (es decir, el valor de propiedad es uno de los de la lista especificada) y None (es decir, no hay valores válidos específicos).

Recursos

Los recursos son marcadores de posición para los datos binarios. Un objeto puede tener más de un recurso. Por ejemplo, si el objeto representa un archivo de imagen con una anotación de audio, los recursos de este objeto pueden ser los siguientes:

• Un recurso predeterminado. Este recurso representa todo el archivo de imagen. (Esto incluye cualquier dato incrustado, como anotaciones de audio, miniaturas, etc.)
• Un recurso en miniatura. Este recurso representa los datos en miniatura de la imagen.
• Un recurso de anotación de audio. Este recurso representa los datos de audio asociados a la imagen.

Atributos de recursos

De forma similar a los atributos de propiedad, los atributos de recursos describen los derechos de acceso, el tamaño, el formato y otra información relacionada con un recurso. Por ejemplo, los atributos de un recurso de anotación de audio en un objeto de imagen pueden especificar la velocidad de bits, el recuento de canales y el formato de datos del audio.

Representación de perfiles y atributos de recursos

El perfil de representación es un método que las aplicaciones usan para detectar los atributos válidos de un recurso determinado. Por ejemplo, un teléfono móvil puede admitir mapas de bits con restricciones específicas en los valores mínimo y máximo de ancho y alto. Al consultar los perfiles de representación del objeto de mapa de bits, una aplicación puede recuperar esos valores exactos.

La siguiente salida de ejemplo identifica la información del perfil de representación que el dispositivo devolvería si admitía mapas de bits con un alto mínimo de 10 píxeles, un ancho mínimo de 20 píxeles, un alto máximo de 1000 píxeles y un ancho máximo de 2000 píxeles.

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

Consulte el tema Recuperación de las funcionalidades de representación compatibles con un dispositivo en la guía de programación para obtener una descripción de cómo la aplicación puede recuperar un perfil de representación (y los atributos de recursos asociados).

Temas relacionados

Introducción a la aplicación