Clase GCKMediaMetadata

Referencia de la clase GCKMediaMetadata

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:

Campo Tipo de valor Tipos de metadatos válidos
kGCKMetadataKeyCreationDate NSDate GCKMediaMetadataTypePhoto
kGCKMetadataKeyReleaseDate NSDate GCKMediaMetadataTypeGeneric, GCKMediaMetadataTypeMovie, GCKMediaMetadataTypeTVShow, GCKMediaMetadataTypeMusicTrack
kGCKMetadataKeyBroadcastDate NSDate GCKMediaMetadataTypeTVShow
kGCKMetadataKeyTitle NSString GCKMediaMetadataTypeGeneric, GCKMediaMetadataTypeMovie, GCKMediaMetadataTypeTVShow, GCKMediaMetadataTypeMusicTrack y GCKMediaMetadataTypePhoto
kGCKMetadataKeySubtitle NSString GCKMediaMetadataTypeGeneric, GCKMediaMetadataTypeMovie
kGCKMetadataKeyArtist NSString GCKMediaMetadataTypeGeneric, GCKMediaMetadataTypeMusicTrack, GCKMediaMetadataTypePhoto
kGCKMetadataKeyAlbumArtist NSString GCKMediaMetadataTypeMusicTrack
kGCKMetadataKeyAlbumTitle NSString GCKMediaMetadataTypeMusicTrack
kGCKMetadataKeyComposer NSString GCKMediaMetadataTypeMusicTrack
kGCKMetadataKeyDiscNumber NSInteger GCKMediaMetadataTypeMusicTrack
kGCKMetadataKeyTrackNumber NSInteger GCKMediaMetadataTypeMusicTrack
kGCKMetadataKeySeasonNumber NSInteger GCKMediaMetadataTypeTVShow
kGCKMetadataKeyEpisodeNumber NSInteger GCKMediaMetadataTypeTVShow
kGCKMetadataKeySeriesTitle NSString GCKMediaMetadataTypeTVShow
kGCKMetadataKeyStudio NSString GCKMediaMetadataTypeMovie
kGCKMetadataKeyWidth NSInteger GCKMediaMetadataTypePhoto
kGCKMetadataKeyHeight NSInteger GCKMediaMetadataTypePhoto
kGCKMetadataKeyLocationName NSString GCKMediaMetadataTypePhoto
kGCKMetadataKeyLocationLatitude double GCKMediaMetadataTypePhoto
kGCKMetadataKeyLocationLongitude double GCKMediaMetadataTypePhoto

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
metadataTypeThe 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
imageThe image to add.
- (BOOL) containsKey: (NSString *)  key

Prueba si el objeto contiene un campo con la clave determinada.

Parameters
keyThe 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
keyThe 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
valueThe new value for the field.
keyThe key for the field.
Excepciones
NSInvalidArgumentExceptionSi 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
keyThe key for the field.
Muestra
El valor del campo o nil si no se estableció el campo.
Excepciones
NSInvalidArgumentExceptionSi 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
valueThe new value for the field.
keyThe key for the field.
Excepciones
NSInvalidArgumentExceptionSi 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
keyThe key for the field.
Muestra
El valor del campo o 0 si no se estableció el campo.
Excepciones
NSInvalidArgumentExceptionSi 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
keyThe key for the field.
defaultValueThe 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
NSInvalidArgumentExceptionSi 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
valueThe new value for the field.
keyThe key for the field.
Excepciones
NSInvalidArgumentExceptionSi 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
keyThe key for the field.
Muestra
El valor del campo o 0 si no se estableció el campo.
Excepciones
NSInvalidArgumentExceptionSi 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
defaultValueThe value to return if the field has not been set.
keyThe key for the field.
Muestra
El valor del campo o el valor predeterminado proporcionado si no se configuró el campo.
Excepciones
NSInvalidArgumentExceptionSi 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
dateThe new value for the field.
keyThe key for the field.
Excepciones
NSInvalidArgumentExceptionSi 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
keyThe field name.
Muestra
La fecha o nil si no se configuró este campo.
Excepciones
NSInvalidArgumentExceptionSi 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
keyThe 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
NSInvalidArgumentExceptionSi 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

- (GCKMediaMetadataType) metadataType
readnonatomicassign

Es el tipo de metadatos.