Clase GCKMediaMetadata

Referencia de la clase GCKMediaMetadata

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

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

Parameters
keyThe 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
keyThe 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
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.
- (nullable NSString *) stringForKey: (NSString *)  key

Lee el valor de un campo de string.

Parameters
keyThe key for the field.
Devuelve
El valor del campo o nil si no se configuró.
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úmero entero.
- (NSInteger) integerForKey: (NSString *)  key

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

Parameters
keyThe key for the field.
Devuelve
Es el valor del campo, o 0 si no se configuró.
Excepciones
NSInvalidArgumentExceptionsi 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
keyThe key for the field.
defaultValueThe 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
NSInvalidArgumentExceptionsi 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
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 double.
- (double) doubleForKey: (NSString *)  key

Lee el valor de un campo double.

Parameters
keyThe key for the field.
Devuelve
Es el valor del campo, o 0 si no se configuró.
Excepciones
NSInvalidArgumentExceptionSi 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
defaultValueThe value to return if the field has not been set.
keyThe key for the field.
Devuelve
El valor del campo, o el valor predeterminado determinado si no se configuró el campo.
Excepciones
NSInvalidArgumentExceptionSi 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
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.
- (nullable NSDate *) dateForKey: (NSString *)  key

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

Parameters
keyThe field name.
Devuelve
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.
- (nullable NSString *) dateAsStringForKey: (NSString *)  key

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

Parameters
keyThe 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
NSInvalidArgumentExceptionsi 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.