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:
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 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... | |
| (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 de la representación restringida en formato ISO-8601 de la fecha. Más... | |
| (nullable NSString *) | - 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... | |
| 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 string: 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: sección Hora de inicio en los medios. Más... | |
| NSString *const | kGCKMetadataKeySectionStartAbsoluteTime |
| Clave doble: sección absoluta de la hora de inicio. Más... | |
| NSString *const | kGCKMetadataKeySectionStartTimeInContainer |
| Clave doble: sección de tiempo de inicio en el contenedor. Más... | |
| NSString *const | kGCKMetadataKeyQueueItemID |
| Clave doble: ID de elemento en cola. 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
YESsi 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.
| - (nullable id) 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
nilsi 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.
| - (nullable NSString *) 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
nilsi 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.
| - (nullable NSDate *) 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
nilsi no se configuró este campo.
- Excepciones
-
NSInvalidArgumentException si la clave se refiere 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 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
nilsi 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.
| - (NSString* const) kGCKMetadataKeyBookTitle |
Clave de string: título del libro.
El título de un audiolibro.
- Since
- 4.3.5
| - (NSString* const) kGCKMetadataKeyChapterNumber |
Clave de número entero: número de capítulo.
Indica la cantidad de capítulos de un audiolibro.
- Since
- 4.3.5
| - (NSString* const) kGCKMetadataKeyChapterTitle |
Clave de string: título del capítulo.
Título de un capítulo de un audiolibro
- Since
- 4.3.5
| - (NSString* const) kGCKMetadataKeySectionDuration |
Clave doble: Duración de la sección.
La duración de la sección en segundos. Se usa para los metadatos de la cola. Por ejemplo, puede ser la duración de un programa de TV en fila, la duración de un capítulo de un audiolibro o un programa de una transmisión en vivo larga.
- Since
- 4.4.1
| - (NSString* const) kGCKMetadataKeySectionStartTimeInMedia |
Clave doble: sección Hora de inicio en los medios.
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 la cola.
- Since
- 4.4.1
| - (NSString* const) kGCKMetadataKeySectionStartAbsoluteTime |
Clave doble: sección absoluta de la hora de inicio.
El tiempo absoluto del inicio de la sección, en tiempo del ciclo en segundos. Se usa para los metadatos de la cola.
- Since
- 4.4.1
| - (NSString* const) kGCKMetadataKeySectionStartTimeInContainer |
Clave doble: sección de tiempo de inicio en el contenedor.
El desplazamiento de la hora de inicio de la sección dentro del contenedor completo Se usa para los metadatos de la cola.
- Since
- 4.4.1
| - (NSString* const) kGCKMetadataKeyQueueItemID |
Clave doble: ID de elemento en cola.
Es el ID del elemento de la cola que incluye la hora de inicio de la sección. Se usa para los metadatos de la cola.
- Since
- 4.4.1
Detalles de la propiedad
|
readnonatomicassign |
El tipo de metadatos.