Descripción general

Un contenedor para los metadatos del contenido multimedia.

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 otros campos por su cuenta.

Los valores de los campos predefinidos tienen tipos predefinidos. Por ejemplo, un número de pista es una NSInteger y una fecha de creación es una 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 mostrará una NSInvalidArgumentException.

Ten en cuenta que el protocolo Cast limita los campos de metadatos que se pueden usar para un determinado tipo de medio. Cuando un objeto MediaMetadata se serializa en JSON para su entrega a un receptor de Cast, los campos predefinidos que no sean compatibles con un determinado tipo de medio no se incluirán en el formulario serializado, pero siempre se incluirán los campos definidos por la aplicación. La lista completa de los campos predefinidos es la siguiente:

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

Hereda NSObject. Implementa <NSCopy>.

Resumen del método de instancia
(instancetype)	- initWithMetadataType:
	Inicializa un MediaMetadata nuevo y vacío con el tipo de medio especificado. Más...

(instancetype)	- init
	Inicializa con el tipo de metadatos genérico. Más...

(GCKMediaMetadataType)	- metadataType
	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:
	Comprueba si el objeto contiene un campo con la clave dada. Más...

(NSArray< NSString * > *)	- allKeys
	Muestra un conjunto de claves para todos los campos que están 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 string. Más...

(NSString *__nullable)	- stringForKey:
	Lee el valor de un campo de string. 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 double. Más...

(double)	- doubleForKey:
	Lee el valor de un campo double. Más...

(double)	- doubleForKey:defaultValue:
	Lee el valor de un campo double. Más...

(void)	- setDate:forKey:
	Almacena un valor en un campo de fecha como una representación ISO-8601 restringida de la fecha. Más...

(NSDate *__nullable)	- dateForKey:
	Lee el valor de un campo de fecha de la representación restringida en formato ISO-8601 de la fecha. Más...

(NSString *__nullable)	- dateAsStringForKey:
	Lee el valor de un campo de fecha, como una string. Más...

Atributos públicos
NSString *const	kGCKMetadataKeyCreationDate
	Clave de string: fecha de creación. Más...

NSString *const	kGCKMetadataKeyReleaseDate
	Clave de string: fecha de lanzamiento Más...

NSString *const	kGCKMetadataKeyBroadcastDate
	Clave de string: fecha de emisión Más...

NSString *const	kGCKMetadataKeyTitle
	Clave de string: título Más...

NSString *const	kGCKMetadataKeySubtitle
	Clave de string: Subtitle. Más...

NSString *const	kGCKMetadataKeyArtist
	Clave de string: Artista. Más...

NSString *const	kGCKMetadataKeyAlbumArtist
	Clave de string: artista del álbum. Más...

NSString *const	kGCKMetadataKeyAlbumTitle
	Clave de string: título del álbum. Más...

NSString *const	kGCKMetadataKeyComposer
	Clave de string: 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 seguimiento. Más...

NSString *const	kGCKMetadataKeySeasonNumber
	Clave de número entero: 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 string: título de la serie. Más...

NSString *const	kGCKMetadataKeyStudio
	Clave de string: 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 string: nombre de la ubicación Más...

NSString *const	kGCKMetadataKeyLocationLatitude
	Clave doble: Latitud de la ubicación. Más...

NSString *const	kGCKMetadataKeyLocationLongitude
	Clave doble: Longitud de la ubicación. Más...

Resumen de la propiedad
GCKMediaMetadataType	metadataType
	El tipo de metadatos. Más...

Detalle del método

- (instancetype) initWithMetadataType: (GCKMediaMetadataType) metadataType

Inicializa un MediaMetadata nuevo y vacío con el tipo de medio especificado.

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

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

Comprueba si el objeto contiene un campo con la clave dada.

Parameters

key The key.

Resultado que se muestra: YES si el campo existe; de lo contrario, NO.

- (NSArray<NSString *> *) allKeys

Muestra un conjunto de claves para todos los campos que están presentes en el objeto.

- (id __nullable) objectForKey: (NSString *) key

Lee el valor de un campo.

Parameters

key	The key for the field.

Resultado que se muestra: Es el valor del campo o nil si no se configuró.

- (void) setString:	(NSString *)	value
forKey:	(NSString *)	key

Almacena un valor en un campo de string.

Parameters

value	The new value for the field.
key	The key for the field.

Excepciones

NSInvalidArgumentException si la clave se refiere a un campo predefinido que no es un campo de string.

- (NSString *__nullable) stringForKey: (NSString *) key

Lee el valor de un campo de string.

Parameters

key	The key for the field.

Resultado que se muestra: Es el valor del campo o nil si no se configuró.

Excepciones

NSInvalidArgumentException si la clave se refiere a un campo predefinido que no es un campo de string.

- (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 se refiere a un campo predefinido que no es un campo entero.

- (NSInteger) integerForKey: (NSString *) key

Lee el valor de un campo de número entero.

Parameters

key	The key for the field.

Resultado que se muestra: El valor del campo, o 0 si no se definió ninguno.

Excepciones

NSInvalidArgumentException si la clave se refiere a un campo predefinido que no es un campo entero.

- (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.

Resultado que se muestra: Es el valor del campo o el valor predeterminado, si no se configuró uno.

Excepciones

NSInvalidArgumentException si la clave se refiere a un campo predefinido que no es un campo entero.

- (void) setDouble:	(double)	value
forKey:	(NSString *)	key

Almacena un valor en un campo double.

Parameters

value	The new value for the field.
key	The key for the field.

Excepciones

NSInvalidArgumentException si la clave se refiere a un campo predefinido que no es un campo double.

- (double) doubleForKey: (NSString *) key

Lee el valor de un campo double.

Parameters

key	The key for the field.

Resultado que se muestra: El valor del campo, o 0 si no se definió ninguno.

Excepciones

NSInvalidArgumentException si la clave se refiere a un campo predefinido que no es un campo double.

- (double) doubleForKey:	(NSString *)	key
defaultValue:	(double)	defaultValue

Lee el valor de un campo double.

Parameters

defaultValue	The value to return if the field has not been set.
key	The key for the field.

Resultado que se muestra: Es el valor del campo o el valor predeterminado, si no se configuró uno.

Excepciones

NSInvalidArgumentException si la clave se refiere a un campo predefinido que no es un campo double.

- (void) setDate:	(NSDate *)	date
forKey:	(NSString *)	key

Almacena un valor en un campo de fecha como una representación ISO-8601 restringida de la fecha.

Parameters

date	The new value for the field.
key	The key for the field.

Excepciones

NSInvalidArgumentException si la clave se refiere 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 en formato ISO-8601 de la fecha.

Parameters

key	The field name.

Resultado que se muestra: Es la fecha o nil si no se configuró este campo.

Excepciones

NSInvalidArgumentException si la clave se refiere 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 string.

Parameters

key	The field name.

Resultado que se muestra: Es la fecha como una string 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 se refiere a un campo predefinido que no es un campo de fecha.

Documentación de datos del miembro

- (NSString* const) kGCKMetadataKeyCreationDate

Clave de string: fecha de creación.

El valor es la fecha o la hora en la que se crearon los medios, en formato ISO-8601. Por ejemplo, puede ser la fecha y la hora en las que se tomó una fotografía o se grabó una pieza musical.

- (NSString* const) kGCKMetadataKeyReleaseDate

Clave de string: fecha de lanzamiento

El valor es la fecha o la hora en la que los medios se lanzaron, en formato ISO-8601. Por ejemplo, podría ser la fecha en que se lanzó una película o un álbum de música.

- (NSString* const) kGCKMetadataKeyBroadcastDate

Clave de string: fecha de emisión

El valor es la fecha o la hora en la que se transmitieron los medios por primera vez, en formato ISO-8601. Por ejemplo, podría ser la fecha en que un episodio de un programa de TV se emitió por primera vez.

- (NSString* const) kGCKMetadataKeyTitle

Clave de string: título

El título del contenido multimedia. Por ejemplo, puede 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

Clave de string: Subtitle.

El subtítulo del contenido multimedia. Este valor es adecuado para fines de visualización.

- (NSString* const) kGCKMetadataKeyArtist

Clave de string: Artista.

Corresponde al 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 string: artista del álbum.

El nombre del artista que produjo un álbum. Por ejemplo, en álbumes de compilación, como mixes de DJ, el artista del álbum no es necesariamente el mismo que los artistas de las canciones individuales del álbum. Este valor es adecuado para fines de visualización.

- (NSString* const) kGCKMetadataKeyAlbumTitle

Clave de string: título del álbum.

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 string: Composer.

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.

El número de disco (que cuenta 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 seguimiento.

El número de pista de una pista de música en el disco de un álbum. Por lo general, los números de las pistas se cuentan a partir de 1. Sin embargo, este valor puede ser 0 si es una "pista oculta" al comienzo de un álbum.

- (NSString* const) kGCKMetadataKeySeasonNumber

Clave de número entero: número de temporada.

El número de temporada al que pertenece un episodio de programa de TV. Por lo general, los números de la temporada se cuentan a partir de 1, pero este valor puede ser 0 si se trata de un episodio "piloto" que precede al inicio oficial de una serie de TV.

- (NSString* const) kGCKMetadataKeyEpisodeNumber

Clave de número entero: número de episodio.

Número de episodios de una temporada determinada de un programa de TV Por lo general, los números de los episodios se cuentan a partir de 1, pero el 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 string: título de la serie.

El nombre de una serie. Por ejemplo, puede ser el nombre de un programa de TV o de una serie de álbumes de música relacionados. Este valor es adecuado para fines de visualización.

- (NSString* const) kGCKMetadataKeyStudio

Clave de string: Studio.

El nombre de un estudio de grabación que produjo contenido multimedia. Por ejemplo, puede ser el nombre de un estudio cinematográfico o de un sello discográfico. Este valor es adecuado para fines de visualización.

- (NSString* const) kGCKMetadataKeyWidth

Clave de número entero: ancho.

Ancho de un elemento multimedia, en píxeles. Normalmente, se usa para proporcionar las dimensiones de una fotografía.

- (NSString* const) kGCKMetadataKeyHeight

Clave de número entero: altura.

La altura del elemento multimedia, en píxeles. Normalmente, se usa para proporcionar las dimensiones de una fotografía.

- (NSString* const) kGCKMetadataKeyLocationName

Clave de string: nombre de la ubicación

Es el nombre de una ubicación en la que se creó un elemento 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.

Componente de latitud de la ubicación geográfica en la que se creó un artículo 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

Clave doble: Longitud de la ubicación.

Componente de longitud de la ubicación geográfica donde se creó el artículo 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

El tipo de metadatos.

Clase GCKMediaMetadata

Descripción general

Resumen del método de instancia

Atributos públicos

Resumen de la propiedad

Detalle del método

Documentación de datos del miembro

Detalles de la propiedad