Descripción general

Es un contenedor para metadatos de 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 están predefinidas como constantes, pero la aplicación puede definir y usar campos adicionales propios.

Los valores de los campos predefinidos tienen tipos predefinidos. Por ejemplo, el número de una pista es una NSInteger y una fecha de creación es un elemento NSString que contiene una representación ISO-8601 de una fecha y una hora. Si intentas almacenar un valor de tipo incorrecto en un campo, se generará una NSInvalidArgumentException.

Ten en cuenta que el protocolo de transmisión limita los campos de metadatos que se pueden usar para un tipo de medio determinado. Cuando se serializa un objeto MediaMetadata a JSON para enviarlo a un receptor de transmisión, los campos predefinidos que no son compatibles con un tipo de medio determinado no se incluyen en el formato serializado, pero siempre se incluyen los campos definidos por la aplicación. Esta es la lista completa de campos predefinidos:

Campo	Value Type	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 y 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 NSObject, <NSCopy> y <NSSecureCoding>.

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

(instancetype)	- init
	Inicializa con el tipo de metadatos genéricos. 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:
	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...

(nullable id)	- objectForKey:
	Lee el valor de un campo. Más...

(void)	- setString:forKey:
	Almacena un valor en un campo de string. Más...

(nullable NSString *)	- 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...

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

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

Atributos públicos
NSString *const	kGCKMetadataKeyCreationDate
	Clave de string: 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 string: Título. Más...

NSString *const	kGCKMetadataKeySubtitle
	Clave de string: subtítulo. 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 string: Compositor 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 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
	Tecla doble: Latitud de la ubicación. Más...

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

NSString *const	kGCKMetadataKeyBookTitle
	Clave de string: título del libro. Más...

NSString *const	kGCKMetadataKeyChapterNumber
	Clave de número entero: número de capítulo. Más...

NSString *const	kGCKMetadataKeyChapterTitle
	Clave de cadena: título del capítulo. Más...

NSString *const	kGCKMetadataKeySectionDuration
	Clave doble: Duración de la sección. Más...

NSString *const	kGCKMetadataKeySectionStartTimeInMedia
	Clave doble: Hora de inicio de la sección en contenido multimedia. Más...

NSString *const	kGCKMetadataKeySectionStartAbsoluteTime
	Clave doble: hora de inicio absoluta de la sección. Más...

NSString *const	kGCKMetadataKeySectionStartTimeInContainer
	Clave doble: Hora de inicio de la sección en el contenedor. Más...

NSString *const	kGCKMetadataKeyQueueItemID
	Clave doble: ID de elemento de la cola. 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 MediaMetadata nuevo y vacío con el tipo de medio determinado.

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éricos.

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

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

Parameters

key The key.

Devuelve: YES si el campo existe, NO de lo contrario.

- (NSArray<NSString *> *) allKeys

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

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

Lee el valor de un campo.

Parameters

key	The key for the field.

Devuelve: 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 hace referencia a un campo predefinido que no es un campo de cadena.

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

Lee el valor de un campo de string.

Parameters

key	The key for the field.

Devuelve: El valor del campo o nil si no se configuró.

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úmero entero.

- (NSInteger) integerForKey: (NSString *) key

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

Parameters

key	The key for the field.

Devuelve: Es el valor del campo, o 0 si no se configuró.

Excepciones

NSInvalidArgumentException si la clave hace referencia a un campo predefinido que no es un campo de número 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.

Devuelve: El valor del campo, o el valor predeterminado determinado si no se configuró el campo.

Excepciones

NSInvalidArgumentException si la clave hace referencia a un campo predefinido que no es un campo de número 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 hace referencia 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.

Devuelve: Es el valor del campo, o 0 si no se configuró.

Excepciones

NSInvalidArgumentException Si la clave hace referencia 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.

Devuelve: El valor del campo, o el valor predeterminado determinado si no se configuró el campo.

Excepciones

NSInvalidArgumentException Si la clave hace referencia 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 hace referencia a un campo predefinido que no es un campo de fecha.

- (nullable NSDate *) dateForKey: (NSString *) key

Lee el valor de un campo de fecha desde la representación restringida ISO-8601 de la fecha.

Parameters

key	The field name.

Devuelve: 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.

- (nullable NSString *) dateAsStringForKey: (NSString *) key

Lee el valor de un campo de fecha, como una cadena.

Parameters

key	The field name.

Devuelve: Es la fecha como una string que contiene la representación restringida en formato ISO-8601 de la fecha, o bien 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 sobre los datos de los miembros

- (NSString* const) kGCKMetadataKeyCreationDate

Clave de string: fecha de creación

El valor es la fecha o la hora en que se creó el medio, en formato ISO-8601. Por ejemplo, podría ser la fecha y la hora en las que se tomó una fotografía o se grabó una canción.

- (NSString* const) kGCKMetadataKeyReleaseDate

Clave de cadena: Fecha de lanzamiento.

El valor es la fecha o la hora en que se lanzó el contenido multimedia, en formato ISO-8601. Por ejemplo, puede ser la fecha en que se lanzó una película o un álbum de música.

- (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 la que se emitió por primera vez el episodio de un programa de TV.

- (NSString* const) kGCKMetadataKeyTitle

Clave de string: Título.

Es 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: subtítulo.

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, puede ser el nombre de un músico, artista o fotógrafo. Este valor es adecuado para fines de visualización.

- (NSString* const) kGCKMetadataKeyAlbumArtist

Clave de cadena: artista del álbum.

El nombre del artista que produjo el álbum. Por ejemplo, en las compilaciones de álbumes como mixes de DJ, el artista del álbum no es necesariamente el mismo que el de los artistas 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 string: Compositor

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.

Es el número de disco (en cuenta desde 1) al que pertenece una pista musical 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 de música en un disco de álbum. Por lo general, los números de pistas se cuentan a partir de 1. Sin embargo, este valor puede ser 0 si se trata de una "pista oculta" al comienzo del álbum.

- (NSString* const) kGCKMetadataKeySeasonNumber

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

Indica el número de temporada al que pertenece el episodio de un programa de TV. Por lo general, los números de temporadas se cuentan a partir de 1; sin embargo, este valor puede ser 0 si se trata de un episodio "piloto" anterior al comienzo oficial de una serie de TV.

- (NSString* const) kGCKMetadataKeyEpisodeNumber

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

Indica la cantidad de episodios en una temporada determinada de un programa de TV. Por lo general, la cantidad de episodios se cuenta a partir de 1. Sin embargo, este valor puede ser 0 si es 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.

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

- (NSString* const) kGCKMetadataKeyStudio

Clave de string: Studio.

Es el nombre de un estudio de grabación que produjo un archivo multimedia. Por ejemplo, podría ser el nombre de un estudio cinematográfico 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 en píxeles de un medio. 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 contenido multimedia (en píxeles). Por lo general, 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 la ubicación en la que se creó el contenido multimedia. Por ejemplo, podría ser la ubicación de una fotografía o la ubicación principal de una película. Este valor es adecuado para fines de visualización.

- (NSString* const) kGCKMetadataKeyLocationLatitude

Tecla doble: Latitud de la ubicación.

El componente de latitud de la ubicación geográfica donde se creó un medio. Por ejemplo, podría ser la ubicación de una fotografía o la ubicación principal de una película.

- (NSString* const) kGCKMetadataKeyLocationLongitude

Clave doble: Longitud de la ubicación.

Es el componente de longitud de la ubicación geográfica donde se creó un contenido multimedia. Por ejemplo, podría ser la ubicación de una fotografía o la ubicación principal de una película.

- (NSString* const) kGCKMetadataKeyBookTitle

Clave de string: título del libro.

Es el título de un audiolibro.

Desde: 4.3.5

- (NSString* const) kGCKMetadataKeyChapterNumber

Clave de número entero: número de capítulo.

Es el número de un capítulo de un audiolibro.

Desde: 4.3.5

- (NSString* const) kGCKMetadataKeyChapterTitle

Clave de cadena: título del capítulo.

Es el título de un capítulo de un audiolibro.

Desde: 4.3.5

- (NSString* const) kGCKMetadataKeySectionDuration

Clave doble: Duración de la sección.

Es la duración de la sección en segundos. Se usa para los metadatos de las colas. Por ejemplo, podría ser la duración de un programa de TV en una fila, la duración de un capítulo de un audiolibro o un programa de una transmisión en vivo larga.

Desde: 4.4.1

- (NSString* const) kGCKMetadataKeySectionStartTimeInMedia

Clave doble: Hora de inicio de la sección en contenido multimedia.

El desplazamiento de la hora de inicio de la sección desde el inicio del elemento multimedia en segundos. Se usa para los metadatos de las colas.

Desde: 4.4.1

- (NSString* const) kGCKMetadataKeySectionStartAbsoluteTime

Clave doble: hora de inicio absoluta de la sección.

Es el tiempo absoluto del inicio de la sección, expresado en segundos y la época. Se usa para los metadatos de las colas.

Desde: 4.4.1

- (NSString* const) kGCKMetadataKeySectionStartTimeInContainer

Clave doble: Hora de inicio de la sección en el contenedor.

La compensación de la hora de inicio de la sección dentro del contenedor completo. Se usa para los metadatos de las colas.

Desde: 4.4.1

- (NSString* const) kGCKMetadataKeyQueueItemID

Clave doble: ID de elemento de la cola.

El ID del elemento de la cola que incluye la hora de inicio de la sección. Se usa para los metadatos de las colas.

Desde: 4.4.1

Detalles de la propiedad

- (GCKMediaMetadataType) metadataType

readnonatomicassign

Es 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 sobre los datos de los miembros

Detalles de la propiedad