Descripción general
Es un contenedor para los metadatos de medios.
Los metadatos tienen un tipo de medio, una lista opcional de imágenes y una colección de campos de metadatos. Las claves para los campos de metadatos comunes se predefinen como constantes, pero la aplicación puede definir y usar campos adicionales propios.
Los valores de los campos predefinidos tienen tipos predefinidos. Por ejemplo, un número de pista es un NSInteger
y una fecha de creación es un NSString que contiene una representación ISO-8601 de una fecha y hora. Si intentas almacenar un valor de un tipo incorrecto en un campo, se generará una NSInvalidArgumentException.
Ten en cuenta que el protocolo de Cast limita los campos de metadatos que se pueden usar para un tipo de medio determinado. Cuando un objeto MediaMetadata se serializa en JSON para su entrega a un receptor de Cast, los campos predefinidos que no se admitan para un tipo de medio determinado no se incluirán en la forma serializada, pero los campos definidos por la aplicación siempre se incluirán. A continuación, se incluye la lista completa de campos predefinidos:
Hereda de NSObject. Implementa <NSCopying>.
Resumen de métodos de instancia | |
(instancetype) | - initWithMetadataType: |
Inicializa un objeto MediaMetadata nuevo y vacío con el tipo de medio determinado. Más… | |
(instancetype) | - init |
Inicializa con el tipo de metadatos genérico. Más… | |
(GCKMediaMetadataType) | - metadataType |
Es el tipo de metadatos. Más… | |
(NSArray *) | - images |
Obtiene la lista de imágenes. Más… | |
(void) | - removeAllMediaImages |
Quita todas las imágenes actuales. Más… | |
(void) | - addImage: |
Agrega una imagen a la lista de imágenes. Más… | |
(BOOL) | - containsKey: |
Prueba si el objeto contiene un campo con la clave determinada. Más… | |
(NSArray< NSString * > *) | - allKeys |
Devuelve un conjunto de claves para todos los campos presentes en el objeto. Más… | |
(id __nullable) | - objectForKey: |
Lee el valor de un campo. Más… | |
(void) | - setString:forKey: |
Almacena un valor en un campo de cadena. Más… | |
(NSString *__nullable) | - stringForKey: |
Lee el valor de un campo de cadena. Más… | |
(void) | - setInteger:forKey: |
Almacena un valor en un campo de número entero. Más… | |
(NSInteger) | - integerForKey: |
Lee el valor de un campo de número entero. Más… | |
(NSInteger) | - integerForKey:defaultValue: |
Lee el valor de un campo de número entero. Más… | |
(void) | - setDouble:forKey: |
Almacena un valor en un campo doble. Más… | |
(double) | - doubleForKey: |
Lee el valor de un campo doble. Más… | |
(double) | - doubleForKey:defaultValue: |
Lee el valor de un campo doble. Más… | |
(void) | - setDate:forKey: |
Almacena un valor en un campo de fecha como una representación restringida de la fecha en formato ISO-8601. Más… | |
(NSDate *__nullable) | - dateForKey: |
Lee el valor de un campo de fecha de la representación restringida ISO-8601 de la fecha. Más… | |
(NSString *__nullable) | - dateAsStringForKey: |
Lee el valor de un campo de fecha como una cadena. Más… | |
Atributos públicos | |
NSString *const | kGCKMetadataKeyCreationDate |
Clave de cadena: Fecha de creación. Más… | |
NSString *const | kGCKMetadataKeyReleaseDate |
Clave de cadena: Fecha de lanzamiento. Más… | |
NSString *const | kGCKMetadataKeyBroadcastDate |
Clave de cadena: Fecha de transmisión. Más… | |
NSString *const | kGCKMetadataKeyTitle |
Clave de cadena: Título. Más… | |
NSString *const | kGCKMetadataKeySubtitle |
Es la clave de la cadena Subtitle. Más… | |
NSString *const | kGCKMetadataKeyArtist |
Clave de cadena: Artista. Más… | |
NSString *const | kGCKMetadataKeyAlbumArtist |
Clave de cadena: Artista del álbum. Más… | |
NSString *const | kGCKMetadataKeyAlbumTitle |
Clave de cadena: Título del álbum. Más… | |
NSString *const | kGCKMetadataKeyComposer |
Clave de cadena: Composer. Más… | |
NSString *const | kGCKMetadataKeyDiscNumber |
Clave de número entero: Número de disco. Más… | |
NSString *const | kGCKMetadataKeyTrackNumber |
Clave de número entero: Número de pista. Más… | |
NSString *const | kGCKMetadataKeySeasonNumber |
Clave entera: Número de temporada. Más… | |
NSString *const | kGCKMetadataKeyEpisodeNumber |
Clave de número entero: Número de episodio. Más… | |
NSString *const | kGCKMetadataKeySeriesTitle |
Clave de cadena: Título de la serie. Más… | |
NSString *const | kGCKMetadataKeyStudio |
Clave de cadena: Studio. Más… | |
NSString *const | kGCKMetadataKeyWidth |
Clave de número entero: Ancho. Más… | |
NSString *const | kGCKMetadataKeyHeight |
Clave de número entero: altura. Más… | |
NSString *const | kGCKMetadataKeyLocationName |
Clave de cadena: Nombre de la ubicación. Más… | |
NSString *const | kGCKMetadataKeyLocationLatitude |
Clave doble: Latitud de la ubicación. Más… | |
NSString *const | kGCKMetadataKeyLocationLongitude |
Doble clave: Longitud de la ubicación. Más… | |
Resumen de la propiedad | |
GCKMediaMetadataType | metadataType |
Es el tipo de metadatos. Más… | |
Detalle del método
- (instancetype) initWithMetadataType: | (GCKMediaMetadataType) | metadataType |
Inicializa un objeto MediaMetadata nuevo y vacío con el tipo de medio determinado.
Es el inicializador designado.
- Parameters
-
metadataType The media type; one of the GCKMediaMetadataType constants, or a value greater than or equal to GCKMediaMetadataTypeUser for custom media types.
- (instancetype) init |
Inicializa con el tipo de metadatos genérico.
- (GCKMediaMetadataType) metadataType |
Es el tipo de metadatos.
- (NSArray *) images |
Obtiene la lista de imágenes.
- (void) removeAllMediaImages |
Quita todas las imágenes actuales.
- (void) addImage: | (GCKImage *) | image |
Agrega una imagen a la lista de imágenes.
- Parameters
-
image The image to add.
- (BOOL) containsKey: | (NSString *) | key |
Prueba si el objeto contiene un campo con la clave determinada.
- Parameters
-
key The key.
- Muestra
YES
si el campo existe; de lo contrario,NO
.
- (NSArray<NSString *> *) allKeys |
Devuelve un conjunto de claves para todos los campos presentes en el objeto.
- (id __nullable) objectForKey: | (NSString *) | key |
Lee el valor de un campo.
- Parameters
-
key The key for the field.
- Muestra
- El valor del campo o
nil
si no se estableció el campo.
- (void) setString: | (NSString *) | value | |
forKey: | (NSString *) | key | |
Almacena un valor en un campo de cadena.
- Parameters
-
value The new value for the field. key The key for the field.
- Excepciones
-
NSInvalidArgumentException Si la clave hace referencia a un campo predefinido que no es un campo de cadena.
- (NSString *__nullable) stringForKey: | (NSString *) | key |
Lee el valor de un campo de cadena.
- Parameters
-
key The key for the field.
- Muestra
- El valor del campo o
nil
si no se estableció el campo.
- Excepciones
-
NSInvalidArgumentException Si la clave hace referencia a un campo predefinido que no es un campo de cadena.
- (void) setInteger: | (NSInteger) | value | |
forKey: | (NSString *) | key | |
Almacena un valor en un campo de número entero.
- Parameters
-
value The new value for the field. key The key for the field.
- Excepciones
-
NSInvalidArgumentException Si la clave hace referencia a un campo predefinido que no es un campo de números enteros.
- (NSInteger) integerForKey: | (NSString *) | key |
Lee el valor de un campo de número entero.
- Parameters
-
key The key for the field.
- Muestra
- El valor del campo o 0 si no se estableció el campo.
- Excepciones
-
NSInvalidArgumentException Si la clave hace referencia a un campo predefinido que no es un campo de números enteros.
- (NSInteger) integerForKey: | (NSString *) | key | |
defaultValue: | (NSInteger) | defaultValue | |
Lee el valor de un campo de número entero.
- Parameters
-
key The key for the field. defaultValue The value to return if the field has not been set.
- Muestra
- El valor del campo o el valor predeterminado proporcionado si no se configuró el campo.
- Excepciones
-
NSInvalidArgumentException Si la clave hace referencia a un campo predefinido que no es un campo de números enteros.
- (void) setDouble: | (double) | value | |
forKey: | (NSString *) | key | |
Almacena un valor en un campo doble.
- Parameters
-
value The new value for the field. key The key for the field.
- Excepciones
-
NSInvalidArgumentException Si la clave hace referencia a un campo predefinido que no es un campo doble
- (double) doubleForKey: | (NSString *) | key |
Lee el valor de un campo doble.
- Parameters
-
key The key for the field.
- Muestra
- El valor del campo o 0 si no se estableció el campo.
- Excepciones
-
NSInvalidArgumentException Si la clave hace referencia a un campo predefinido que no es un campo doble
- (double) doubleForKey: | (NSString *) | key | |
defaultValue: | (double) | defaultValue | |
Lee el valor de un campo doble.
- Parameters
-
defaultValue The value to return if the field has not been set. key The key for the field.
- Muestra
- El valor del campo o el valor predeterminado proporcionado si no se configuró el campo.
- Excepciones
-
NSInvalidArgumentException Si la clave hace referencia a un campo predefinido que no es un campo doble
- (void) setDate: | (NSDate *) | date | |
forKey: | (NSString *) | key | |
Almacena un valor en un campo de fecha como una representación restringida de la fecha en formato ISO-8601.
- Parameters
-
date The new value for the field. key The key for the field.
- Excepciones
-
NSInvalidArgumentException Si la clave hace referencia a un campo predefinido que no es un campo de fecha
- (NSDate *__nullable) dateForKey: | (NSString *) | key |
Lee el valor de un campo de fecha de la representación restringida ISO-8601 de la fecha.
- Parameters
-
key The field name.
- Muestra
- La fecha o
nil
si no se configuró este campo.
- Excepciones
-
NSInvalidArgumentException Si la clave hace referencia a un campo predefinido que no es un campo de fecha
- (NSString *__nullable) dateAsStringForKey: | (NSString *) | key |
Lee el valor de un campo de fecha como una cadena.
- Parameters
-
key The field name.
- Muestra
- Fecha como una cadena que contiene la representación restringida de la fecha según ISO-8601, o
nil
si no se configuró este campo.
- Excepciones
-
NSInvalidArgumentException Si la clave hace referencia a un campo predefinido que no es un campo de fecha
Documentación de los datos de miembros
- (NSString* const) kGCKMetadataKeyCreationDate |
Clave de cadena: Fecha de creación.
El valor es la fecha o la hora en la que se creó el contenido multimedia, en formato ISO-8601. Por ejemplo, podría ser la fecha y la hora en que se tomó una fotografía o se grabó una pieza musical.
- (NSString* const) kGCKMetadataKeyReleaseDate |
Clave de cadena: Fecha de lanzamiento.
El valor es la fecha o la hora en la que se lanzó el contenido multimedia, en formato ISO-8601. Por ejemplo, podría ser la fecha de lanzamiento de una película o un álbum musical.
- (NSString* const) kGCKMetadataKeyBroadcastDate |
Clave de cadena: Fecha de transmisión.
El valor es la fecha o la hora en la que se transmitió el contenido multimedia por primera vez, en formato ISO-8601. Por ejemplo, podría ser la fecha en que se emitió por primera vez un episodio de un programa de TV.
- (NSString* const) kGCKMetadataKeyTitle |
Clave de cadena: Título.
Es el título del contenido multimedia. Por ejemplo, podría ser el título de una canción, una película o un episodio de un programa de TV. Este valor es adecuado para fines de visualización.
- (NSString* const) kGCKMetadataKeySubtitle |
Es la clave de la cadena Subtitle.
Es el subtítulo del contenido multimedia. Este valor es adecuado para fines de visualización.
- (NSString* const) kGCKMetadataKeyArtist |
Clave de cadena: Artista.
Es el nombre del artista que creó el contenido multimedia. Por ejemplo, podría ser el nombre de un músico, un artista o un fotógrafo. Este valor es adecuado para fines de visualización.
- (NSString* const) kGCKMetadataKeyAlbumArtist |
Clave de cadena: Artista del álbum.
Es el nombre del artista que produjo un álbum. Por ejemplo, en los álbumes de compilación, como las mezclas de DJ, el artista del álbum no necesariamente es el mismo que el de las canciones individuales del álbum. Este valor es adecuado para fines de visualización.
- (NSString* const) kGCKMetadataKeyAlbumTitle |
Clave de cadena: Título del álbum.
Es el título del álbum al que pertenece una pista de música. Este valor es adecuado para fines de visualización.
- (NSString* const) kGCKMetadataKeyComposer |
Clave de cadena: Composer.
Es el nombre del compositor de una pista de música. Este valor es adecuado para fines de visualización.
- (NSString* const) kGCKMetadataKeyDiscNumber |
Clave de número entero: Número de disco.
Número de disco (a partir de 1) al que pertenece una pista de música en un álbum de varios discos.
- (NSString* const) kGCKMetadataKeyTrackNumber |
Clave de número entero: Número de pista.
Es el número de pista de una pista musical en el disco de un álbum. Por lo general, los números de pista se cuentan a partir del 1, pero este valor puede ser 0 si se trata de una "pista oculta" al comienzo de un álbum.
- (NSString* const) kGCKMetadataKeySeasonNumber |
Clave entera: Número de temporada.
Número de la temporada a la que pertenece el episodio de un programa de TV. Por lo general, los números de temporada se cuentan a partir del 1, pero este valor puede ser 0 si se trata de un episodio "piloto" anterior al inicio oficial de una serie de TV.
- (NSString* const) kGCKMetadataKeyEpisodeNumber |
Clave de número entero: Número de episodio.
Número de un episodio en una temporada determinada de un programa de TV. Por lo general, los números de episodio se cuentan a partir del 1. Sin embargo, este valor puede ser 0 si se trata de un episodio "piloto" que no se considera un episodio oficial de la primera temporada.
- (NSString* const) kGCKMetadataKeySeriesTitle |
Clave de cadena: Título de la serie.
Es el nombre de una serie. Por ejemplo, podría ser el nombre de un programa de TV o una serie de álbumes musicales relacionados. Este valor es adecuado para fines de visualización.
- (NSString* const) kGCKMetadataKeyStudio |
Clave de cadena: Studio.
Es el nombre de un estudio de grabación que produjo una pieza de medios. Por ejemplo, podría ser el nombre de un estudio de cine o un sello discográfico. Este valor es adecuado para fines de visualización.
- (NSString* const) kGCKMetadataKeyWidth |
Clave de número entero: Ancho.
Es el ancho de un elemento multimedia, en píxeles. Por lo general, se usa para proporcionar las dimensiones de una fotografía.
- (NSString* const) kGCKMetadataKeyHeight |
Clave de número entero: altura.
Es la altura de un elemento multimedia, en píxeles. Por lo general, se usa para proporcionar las dimensiones de una fotografía.
- (NSString* const) kGCKMetadataKeyLocationName |
Clave de cadena: Nombre de la ubicación.
Nombre de una ubicación en la que se creó un contenido multimedia. Por ejemplo, podría ser la ubicación de una fotografía o la ubicación principal de filmación de una película. Este valor es adecuado para fines de visualización.
- (NSString* const) kGCKMetadataKeyLocationLatitude |
Clave doble: Latitud de la ubicación.
Es el componente de latitud de la ubicación geográfica en la que se creó un contenido multimedia. Por ejemplo, podría ser la ubicación de una fotografía o la ubicación principal de filmación de una película.
- (NSString* const) kGCKMetadataKeyLocationLongitude |
Doble clave: Longitud de la ubicación.
Componente de longitud de la ubicación geográfica en la que se creó un contenido multimedia. Por ejemplo, podría ser la ubicación de una fotografía o la ubicación principal de filmación de una película.
Detalles de la propiedad
|
readnonatomicassign |
Es el tipo de metadatos.