Présentation
Conteneur pour les métadonnées multimédias.
Les métadonnées comprennent un type de contenu multimédia, une liste facultative d'images et un ensemble de champs de métadonnées. Les clés des champs de métadonnées communs sont prédéfinies en tant que constantes, mais l'application est libre de définir et d'utiliser ses propres champs supplémentaires.
Les valeurs des champs prédéfinis sont associées à des types prédéfinis. Par exemple, un numéro de piste est au format NSInteger
, et une date de création est une chaîne NSString contenant une représentation ISO-8601 d'une date et d'une heure. Toute tentative de stockage d'une valeur d'un type incorrect dans un champ génère une erreur NSInvalidArgumentException.
Notez que le protocole Cast limite les champs de métadonnées pouvant être utilisés pour un type de contenu multimédia donné. Lorsqu'un objet MediaMetadata est sérialisé en JSON pour être envoyé à un récepteur Cast, les champs prédéfinis non compatibles avec un type de média donné ne sont pas inclus dans le formulaire sérialisé, mais tous les champs définis par l'application sont toujours inclus. Voici la liste complète des champs prédéfinis:
Hérite de NSObject, <NSCopy> et <NSSecureCoding>.
Résumé des méthodes d'instance | |
(instancetype) | - initWithMetadataType: |
Initialise un nouveau MediaMetadata vide avec le type de média donné. Plus... | |
(instancetype) | - init |
Initialisez avec le type de métadonnées générique. Plus... | |
(GCKMediaMetadataType) | - metadataType |
Type de métadonnées. Plus... | |
(NSArray *) | - images |
Récupère la liste des images. Plus... | |
(void) | - removeAllMediaImages |
Supprime toutes les images actuelles. Plus... | |
(void) | - addImage: |
Ajoute une image à la liste d'images. Plus... | |
(BOOL) | - containsKey: |
Vérifie si l'objet contient un champ avec la clé donnée. Plus... | |
(NSArray< NSString * > *) | - allKeys |
Renvoie un ensemble de clés pour tous les champs présents dans l'objet. Plus... | |
(nullable id) | - objectForKey: |
Lit la valeur d'un champ. Plus... | |
(void) | - setString:forKey: |
Stocke une valeur dans un champ de chaîne. Plus... | |
(nullable NSString *) | - stringForKey: |
Lit la valeur d'un champ de type chaîne. Plus... | |
(void) | - setInteger:forKey: |
Stocke une valeur dans un champ de nombre entier. Plus... | |
(NSInteger) | - integerForKey: |
Lit la valeur d'un champ de nombre entier. Plus... | |
(NSInteger) | - integerForKey:defaultValue: |
Lit la valeur d'un champ de nombre entier. Plus... | |
(void) | - setDouble:forKey: |
Stocke une valeur dans un champ double. Plus... | |
(double) | - doubleForKey: |
Lit la valeur d'un champ double. Plus... | |
(double) | - doubleForKey:defaultValue: |
Lit la valeur d'un champ double. Plus... | |
(void) | - setDate:forKey: |
Stocke une valeur dans un champ de date sous la forme d'une représentation restreinte de la date au format ISO-8601. Plus... | |
(nullable NSDate *) | - dateForKey: |
Lit la valeur d'un champ de date à partir de la représentation restreinte de la date au format ISO-8601. Plus... | |
(nullable NSString *) | - dateAsStringForKey: |
Lit la valeur d'un champ de date, sous forme de chaîne. Plus... | |
Attributs publics | |
NSString *const | kGCKMetadataKeyCreationDate |
Clé de chaîne: date de création Plus... | |
NSString *const | kGCKMetadataKeyReleaseDate |
Clé de chaîne: date de sortie Plus... | |
NSString *const | kGCKMetadataKeyBroadcastDate |
Clé de chaîne: date de diffusion Plus... | |
NSString *const | kGCKMetadataKeyTitle |
Clé de chaîne: titre. Plus... | |
NSString *const | kGCKMetadataKeySubtitle |
Clé de chaîne: sous-titre. Plus... | |
NSString *const | kGCKMetadataKeyArtist |
Clé de chaîne: artiste. Plus... | |
NSString *const | kGCKMetadataKeyAlbumArtist |
Clé de chaîne: Artiste de l'album. Plus... | |
NSString *const | kGCKMetadataKeyAlbumTitle |
Clé de chaîne: titre de l'album. Plus... | |
NSString *const | kGCKMetadataKeyComposer |
Clé de chaîne: Composer. Plus... | |
NSString *const | kGCKMetadataKeyDiscNumber |
Clé entière: numéro de disque. Plus... | |
NSString *const | kGCKMetadataKeyTrackNumber |
Clé entière: numéro de suivi. Plus... | |
NSString *const | kGCKMetadataKeySeasonNumber |
Clé entière: numéro de saison. Plus... | |
NSString *const | kGCKMetadataKeyEpisodeNumber |
Clé entière: numéro de l'épisode. Plus... | |
NSString *const | kGCKMetadataKeySeriesTitle |
Clé de chaîne: titre de la série. Plus... | |
NSString *const | kGCKMetadataKeyStudio |
Clé de chaîne: Studio. Plus... | |
NSString *const | kGCKMetadataKeyWidth |
Clé entière: largeur. Plus... | |
NSString *const | kGCKMetadataKeyHeight |
Clé entière: hauteur. Plus... | |
NSString *const | kGCKMetadataKeyLocationName |
Clé de chaîne: nom de l'emplacement. Plus... | |
NSString *const | kGCKMetadataKeyLocationLatitude |
Clé double: latitude du lieu. Plus... | |
NSString *const | kGCKMetadataKeyLocationLongitude |
Clé double: longitude du lieu. Plus... | |
NSString *const | kGCKMetadataKeyBookTitle |
Clé de chaîne: titre du livre. Plus... | |
NSString *const | kGCKMetadataKeyChapterNumber |
Clé entière: numéro de chapitre. Plus... | |
NSString *const | kGCKMetadataKeyChapterTitle |
Clé de chaîne: titre du chapitre. Plus... | |
NSString *const | kGCKMetadataKeySectionDuration |
Double touche: durée de la section. Plus... | |
NSString *const | kGCKMetadataKeySectionStartTimeInMedia |
Double touche: heure de début de la section dans "Médias". Plus... | |
NSString *const | kGCKMetadataKeySectionStartAbsoluteTime |
Clé double: heure de début absolue de la section. Plus... | |
NSString *const | kGCKMetadataKeySectionStartTimeInContainer |
Clé double: heure de début de la section dans le conteneur. Plus... | |
NSString *const | kGCKMetadataKeyQueueItemID |
Clé double: ID de l'élément de la file d'attente. Plus... | |
Résumé de la propriété | |
GCKMediaMetadataType | metadataType |
Type de métadonnées. Plus... | |
Détails sur la méthode
- (instancetype) initWithMetadataType: | (GCKMediaMetadataType) | metadataType |
Initialise un nouveau MediaMetadata vide avec le type de média donné.
initialiseur désigné.
- 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 |
Initialisez avec le type de métadonnées générique.
- (GCKMediaMetadataType) metadataType |
Type de métadonnées.
- (NSArray *) images |
Récupère la liste des images.
- (void) removeAllMediaImages |
Supprime toutes les images actuelles.
- (void) addImage: | (GCKImage *) | image |
Ajoute une image à la liste d'images.
- Parameters
-
image The image to add.
- (BOOL) containsKey: | (NSString *) | key |
Vérifie si l'objet contient un champ avec la clé donnée.
- Parameters
-
key The key.
- Renvoie
YES
si le champ existe,NO
dans le cas contraire.
- (NSArray<NSString *> *) allKeys |
Renvoie un ensemble de clés pour tous les champs présents dans l'objet.
- (nullable id) objectForKey: | (NSString *) | key |
Lit la valeur d'un champ.
- Parameters
-
key The key for the field.
- Renvoie
- Valeur du champ, ou
nil
si le champ n'a pas été défini.
- (void) setString: | (NSString *) | value | |
forKey: | (NSString *) | key | |
Stocke une valeur dans un champ de chaîne.
- Parameters
-
value The new value for the field. key The key for the field.
- Exceptions
-
NSInvalidArgumentException si la clé fait référence à un champ prédéfini qui n'est pas un champ de type chaîne.
- (nullable NSString *) stringForKey: | (NSString *) | key |
Lit la valeur d'un champ de type chaîne.
- Parameters
-
key The key for the field.
- Renvoie
- Valeur du champ, ou
nil
si le champ n'a pas été défini.
- Exceptions
-
NSInvalidArgumentException si la clé fait référence à un champ prédéfini qui n'est pas un champ de type chaîne.
- (void) setInteger: | (NSInteger) | value | |
forKey: | (NSString *) | key | |
Stocke une valeur dans un champ de nombre entier.
- Parameters
-
value The new value for the field. key The key for the field.
- Exceptions
-
NSInvalidArgumentException si la clé fait référence à un champ prédéfini qui n'est pas un champ d'entiers.
- (NSInteger) integerForKey: | (NSString *) | key |
Lit la valeur d'un champ de nombre entier.
- Parameters
-
key The key for the field.
- Renvoie
- Valeur du champ, ou 0 si le champ n'a pas été défini.
- Exceptions
-
NSInvalidArgumentException si la clé fait référence à un champ prédéfini qui n'est pas un champ d'entiers.
- (NSInteger) integerForKey: | (NSString *) | key | |
defaultValue: | (NSInteger) | defaultValue | |
Lit la valeur d'un champ de nombre entier.
- Parameters
-
key The key for the field. defaultValue The value to return if the field has not been set.
- Renvoie
- Valeur du champ ou valeur par défaut donnée si le champ n'a pas été défini.
- Exceptions
-
NSInvalidArgumentException si la clé fait référence à un champ prédéfini qui n'est pas un champ d'entiers.
- (void) setDouble: | (double) | value | |
forKey: | (NSString *) | key | |
Stocke une valeur dans un champ double.
- Parameters
-
value The new value for the field. key The key for the field.
- Exceptions
-
NSInvalidArgumentException si la clé fait référence à un champ prédéfini qui n'est pas un champ double.
- (double) doubleForKey: | (NSString *) | key |
Lit la valeur d'un champ double.
- Parameters
-
key The key for the field.
- Renvoie
- Valeur du champ, ou 0 si le champ n'a pas été défini.
- Exceptions
-
NSInvalidArgumentException si la clé fait référence à un champ prédéfini qui n'est pas un champ double.
- (double) doubleForKey: | (NSString *) | key | |
defaultValue: | (double) | defaultValue | |
Lit la valeur d'un champ double.
- Parameters
-
defaultValue The value to return if the field has not been set. key The key for the field.
- Renvoie
- Valeur du champ ou valeur par défaut donnée si le champ n'a pas été défini.
- Exceptions
-
NSInvalidArgumentException si la clé fait référence à un champ prédéfini qui n'est pas un champ double.
- (void) setDate: | (NSDate *) | date | |
forKey: | (NSString *) | key | |
Stocke une valeur dans un champ de date sous la forme d'une représentation restreinte de la date au format ISO-8601.
- Parameters
-
date The new value for the field. key The key for the field.
- Exceptions
-
NSInvalidArgumentException si la clé fait référence à un champ prédéfini qui n'est pas un champ de date.
- (nullable NSDate *) dateForKey: | (NSString *) | key |
Lit la valeur d'un champ de date à partir de la représentation restreinte de la date au format ISO-8601.
- Parameters
-
key The field name.
- Renvoie
- Date, ou
nil
si ce champ n'a pas été défini.
- Exceptions
-
NSInvalidArgumentException si la clé fait référence à un champ prédéfini qui n'est pas un champ de date.
- (nullable NSString *) dateAsStringForKey: | (NSString *) | key |
Lit la valeur d'un champ de date, sous forme de chaîne.
- Parameters
-
key The field name.
- Renvoie
- Date sous forme de chaîne contenant sa représentation restreinte au format ISO-8601, ou
nil
si ce champ n'a pas été défini.
- Exceptions
-
NSInvalidArgumentException si la clé fait référence à un champ prédéfini qui n'est pas un champ de date.
Documentation sur les données des membres
- (NSString* const) kGCKMetadataKeyCreationDate |
Clé de chaîne: date de création
La valeur est la date et/ou l'heure à laquelle le média a été créé, au format ISO-8601. Il peut s'agir, par exemple, de la date et de l'heure auxquelles une photo a été prise ou qu'un morceau de musique a été enregistré.
- (NSString* const) kGCKMetadataKeyReleaseDate |
Clé de chaîne: date de sortie
La valeur est la date et/ou l'heure de sortie du média, au format ISO-8601. Il peut s'agir, par exemple, de la date de sortie d'un film ou d'un album musical.
- (NSString* const) kGCKMetadataKeyBroadcastDate |
Clé de chaîne: date de diffusion
La valeur est la date et/ou l'heure à laquelle le média a été diffusé pour la première fois, au format ISO-8601. Il peut s'agir, par exemple, de la date à laquelle un épisode d'une série TV a été diffusé pour la première fois.
- (NSString* const) kGCKMetadataKeyTitle |
Clé de chaîne: titre.
Titre de l'élément multimédia. Par exemple, il peut s'agir du titre d'une chanson, d'un film ou d'un épisode de série TV. Cette valeur convient à des fins d'affichage.
- (NSString* const) kGCKMetadataKeySubtitle |
Clé de chaîne: sous-titre.
Sous-titre du contenu multimédia. Cette valeur convient à des fins d'affichage.
- (NSString* const) kGCKMetadataKeyArtist |
Clé de chaîne: artiste.
Nom de l'artiste qui a créé le média. Il peut s'agir, par exemple, du nom d'un musicien, d'un artiste ou d'un photographe. Cette valeur convient à des fins d'affichage.
- (NSString* const) kGCKMetadataKeyAlbumArtist |
Clé de chaîne: Artiste de l'album.
Nom de l'artiste qui a produit l'album. Par exemple, dans les compilations d'albums tels que les mix de DJ, le nom de l'artiste n'est pas nécessairement le même que celui des titres individuels de l'album. Cette valeur convient à des fins d'affichage.
- (NSString* const) kGCKMetadataKeyAlbumTitle |
Clé de chaîne: titre de l'album.
Titre de l'album auquel le titre musical appartient. Cette valeur convient à des fins d'affichage.
- (NSString* const) kGCKMetadataKeyComposer |
Clé de chaîne: Composer.
Nom du compositeur d'un titre musical. Cette valeur convient à des fins d'affichage.
- (NSString* const) kGCKMetadataKeyDiscNumber |
Clé entière: numéro de disque.
Numéro de disque (en commençant par 1) auquel appartient un titre musical dans un album multidisque.
- (NSString* const) kGCKMetadataKeyTrackNumber |
Clé entière: numéro de suivi.
Numéro d'un titre figurant sur un disque d'album. Les numéros des titres sont généralement comptabilisés à partir de 1, mais cette valeur peut être égale à 0 s'il s'agit d'une "piste masquée" au début d'un album.
- (NSString* const) kGCKMetadataKeySeasonNumber |
Clé entière: numéro de saison.
Numéro de la saison à laquelle appartient l'épisode d'une série TV. Les numéros de saison commencent généralement à partir de 1, mais cette valeur peut être égale à 0 s'il s'agit d'un épisode "pilote" antérieur au lancement officiel d'une série TV.
- (NSString* const) kGCKMetadataKeyEpisodeNumber |
Clé entière: numéro de l'épisode.
Nombre d'épisodes d'une saison donnée d'une série TV. Le nombre d'épisodes est généralement comptabilisé à partir de 1, mais cette valeur peut être égale à 0 s'il s'agit d'un épisode "pilote" qui n'est pas considéré comme un épisode officiel de la première saison.
- (NSString* const) kGCKMetadataKeySeriesTitle |
Clé de chaîne: titre de la série.
Nom d'une série. Il peut s'agir, par exemple, du nom d'une série TV ou d'une série d'albums musicaux associés. Cette valeur convient à des fins d'affichage.
- (NSString* const) kGCKMetadataKeyStudio |
Clé de chaîne: Studio.
Nom d'un studio d'enregistrement qui a produit un média. Il peut s'agir, par exemple, du nom d'un studio de cinéma ou d'une maison de disques. Cette valeur convient à des fins d'affichage.
- (NSString* const) kGCKMetadataKeyWidth |
Clé entière: largeur.
Largeur d'un élément multimédia, en pixels. Il est généralement utilisé pour fournir les dimensions d'une photo.
- (NSString* const) kGCKMetadataKeyHeight |
Clé entière: hauteur.
Hauteur d'un support, en pixels. Il est généralement utilisé pour fournir les dimensions d'une photo.
- (NSString* const) kGCKMetadataKeyLocationName |
Clé de chaîne: nom de l'emplacement.
Nom d'un emplacement dans lequel un élément multimédia a été créé. Il peut s'agir, par exemple, du lieu de prise de vue d'une photo ou du lieu de tournage principal d'un film. Cette valeur convient à des fins d'affichage.
- (NSString* const) kGCKMetadataKeyLocationLatitude |
Clé double: latitude du lieu.
Composant latitude de l'emplacement géographique où un élément multimédia a été créé. Il peut s'agir, par exemple, du lieu de prise de vue d'une photo ou du lieu de tournage principal d'un film.
- (NSString* const) kGCKMetadataKeyLocationLongitude |
Clé double: longitude du lieu.
Composant de longitude de l'emplacement géographique où un élément multimédia a été créé. Il peut s'agir, par exemple, du lieu de prise de vue d'une photo ou du lieu de tournage principal d'un film.
- (NSString* const) kGCKMetadataKeyBookTitle |
Clé de chaîne: titre du livre.
Titre d'un livre audio.
- Depuis
- 4.3.5
- (NSString* const) kGCKMetadataKeyChapterNumber |
Clé entière: numéro de chapitre.
Numéro d'un chapitre d'un livre audio.
- Depuis
- 4.3.5
- (NSString* const) kGCKMetadataKeyChapterTitle |
Clé de chaîne: titre du chapitre.
Titre d'un chapitre d'un livre audio.
- Depuis
- 4.3.5
- (NSString* const) kGCKMetadataKeySectionDuration |
Double touche: durée de la section.
Durée de la section en secondes. Utilisé pour les métadonnées de file d'attente. Par exemple, il peut s'agir de la durée d'une série TV dans la file d'attente, d'un chapitre d'un livre audio ou d'un programme d'une longue diffusion en direct.
- Depuis
- 4.4.1
- (NSString* const) kGCKMetadataKeySectionStartTimeInMedia |
Double touche: heure de début de la section dans "Médias".
Décalage de l'heure de début de la section à partir du début de l'élément multimédia, en secondes. Utilisé pour les métadonnées de file d'attente.
- Depuis
- 4.4.1
- (NSString* const) kGCKMetadataKeySectionStartAbsoluteTime |
Clé double: heure de début absolue de la section.
Heure absolue du début de la section, au format epoch, en secondes. Utilisé pour les métadonnées de file d'attente.
- Depuis
- 4.4.1
- (NSString* const) kGCKMetadataKeySectionStartTimeInContainer |
Clé double: heure de début de la section dans le conteneur.
Décalage de l'heure de début de la section dans le conteneur complet. Utilisé pour les métadonnées de file d'attente.
- Depuis
- 4.4.1
- (NSString* const) kGCKMetadataKeyQueueItemID |
Clé double: ID de l'élément de la file d'attente.
Identifiant de l'élément de la file d'attente, qui inclut l'heure de début de la section. Utilisé pour les métadonnées de file d'attente.
- Depuis
- 4.4.1
Détails de la propriété
|
readnonatomicassign |
Type de métadonnées.