Classe GCKMediaMetadata

Référence de la classe GCKMediaMetadata

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:

Champ Type de valeur Types de métadonnées valides
kGCKMetadataKeyCreationDate NSDate GCKMediaMetadataTypePhoto
kGCKMetadataKeyReleaseDate NSDate GCKMediaMetadataTypeGeneric, GCKMediaMetadataTypeMovie, GCKMediaMetadataTypeTVShow, GCKMediaMetadataTypeMusicTrack
kGCKMetadataKeyBroadcastDate NSDate GCKMediaMetadataTypeTVShow
kGCKMetadataKeyTitle NSString GCKMediaMetadataTypeGeneric, GCKMediaMetadataTypeMovie, GCKMediaMetadataTypeTVShow, GCKMediaMetadataTypeMusicTrack, GCKMediaMetadataTypePhoto
kGCKMetadataKeySubtitle NSString GCKMediaMetadataTypeGeneric, GCKMediaMetadataTypeMovie
kGCKMetadataKeyArtist NSString GCKMediaMetadataTypeGeneric, GCKMediaMetadataTypeMusicTrack et 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

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

Vérifie si l'objet contient un champ avec la clé donnée.

Parameters
keyThe 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
keyThe 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
valueThe new value for the field.
keyThe key for the field.
Exceptions
NSInvalidArgumentExceptionsi 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
keyThe key for the field.
Renvoie
Valeur du champ, ou nil si le champ n'a pas été défini.
Exceptions
NSInvalidArgumentExceptionsi 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
valueThe new value for the field.
keyThe key for the field.
Exceptions
NSInvalidArgumentExceptionsi 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
keyThe key for the field.
Renvoie
Valeur du champ, ou 0 si le champ n'a pas été défini.
Exceptions
NSInvalidArgumentExceptionsi 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
keyThe key for the field.
defaultValueThe 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
NSInvalidArgumentExceptionsi 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
valueThe new value for the field.
keyThe key for the field.
Exceptions
NSInvalidArgumentExceptionsi 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
keyThe key for the field.
Renvoie
Valeur du champ, ou 0 si le champ n'a pas été défini.
Exceptions
NSInvalidArgumentExceptionsi 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
defaultValueThe value to return if the field has not been set.
keyThe 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
NSInvalidArgumentExceptionsi 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
dateThe new value for the field.
keyThe key for the field.
Exceptions
NSInvalidArgumentExceptionsi 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
keyThe field name.
Renvoie
Date, ou nil si ce champ n'a pas été défini.
Exceptions
NSInvalidArgumentExceptionsi 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
keyThe 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
NSInvalidArgumentExceptionsi 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é

- (GCKMediaMetadataType) metadataType
readnonatomicassign

Type de métadonnées.