Présentation

Conteneur de métadonnées multimédias.

Les métadonnées incluent 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 courants 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 ont des types prédéfinis. Par exemple, un numéro de piste est un NSInteger et une date de création est une 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 exception NSInvalidArgumentException.

Notez que le protocole Cast limite les champs de métadonnées pouvant être utilisés pour un type de contenu donné. Lorsqu'un objet MediaMetadata est sérialisé vers JSON pour une diffusion vers un récepteur Cast, les champs prédéfinis non compatibles avec un type de support donné ne sont pas inclus dans le formulaire sérialisé, mais tous les champs définis par l'application le sont toujours. 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, 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. Met en œuvre <NSCopying>.

Résumé de la méthode d'instance
(instancetype)	- initWithMetadataType:
	Initialise une nouvelle ressource MediaMetadata vide avec le type de support 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 des images. Plus...

(BOOL)	- containsKey:
	Teste 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...

(id __nullable)	- objectForKey:
	Lit la valeur d'un champ. Plus...

(void)	- setString:forKey:
	Stocke une valeur dans un champ de type chaîne. Plus...

(NSString *__nullable)	- stringForKey:
	Lit la valeur d'un champ de chaîne. Plus...

(void)	- setInteger:forKey:
	Stocke une valeur dans un champ d'entier. Plus...

(NSInteger)	- integerForKey:
	Lit la valeur d'un champ d'entier. Plus...

(NSInteger)	- integerForKey:defaultValue:
	Lit la valeur d'un champ d'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 ISO-8601 restreinte de la date. Plus...

(NSDate *__nullable)	- dateForKey:
	Lit la valeur d'un champ de date à partir de la représentation ISO-8601 restreinte de la date. Plus...

(NSString *__nullable)	- 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é de nombre entier: numéro de suivi. Plus...

NSString *const	kGCKMetadataKeySeasonNumber
	Clé de nombre entier: numéro de saison. Plus...

NSString *const	kGCKMetadataKeyEpisodeNumber
	Clé entière: numéro d'é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é de l'entier: largeur. Plus...

NSString *const	kGCKMetadataKeyHeight
	Clé de nombre entier: hauteur. Plus...

NSString *const	kGCKMetadataKeyLocationName
	Clé de chaîne: nom de l'emplacement. Plus...

NSString *const	kGCKMetadataKeyLocationLatitude
	Double clé: latitude de l'établissement. Plus...

NSString *const	kGCKMetadataKeyLocationLongitude
	Double clé: longitude du lieu. Plus...

Récapitulatif de la propriété
GCKMediaMetadataType	metadataType
	Type de métadonnées. Plus...

Détails sur la méthode

- (instancetype) initWithMetadataType: (GCKMediaMetadataType) metadataType

Initialise une nouvelle ressource MediaMetadata vide avec le type de support donné.

Initialisation désignée.

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 des images.

Parameters

image The image to add.

- (BOOL) containsKey: (NSString *) key

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

Parameters

key The key.

Retours: YES si le champ existe, sinon NO.

- (NSArray<NSString *> *) allKeys

Renvoie un ensemble de clés pour tous les champs présents dans l'objet.

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

Lit la valeur d'un champ.

Parameters

key	The key for the field.

Retours: 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 type 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.

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

Lit la valeur d'un champ de chaîne.

Parameters

key	The key for the field.

Retours: 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 d'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 d'entier.

Parameters

key	The key for the field.

Retours: 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 d'entier.

Parameters

key	The key for the field.
defaultValue	The value to return if the field has not been set.

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

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

Retours: 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 ISO-8601 restreinte de la date.

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.

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

Lit la valeur d'un champ de date à partir de la représentation ISO-8601 restreinte de la date.

Parameters

key	The field name.

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

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

Lit la valeur d'un champ de date sous forme de chaîne.

Parameters

key	The field name.

Retours: La date sous forme de chaîne contenant la représentation ISO-8601 restreinte de la 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.

Documentation sur les données des membres

- (NSString* const) kGCKMetadataKeyCreationDate

Clé de chaîne: date de création.

La valeur indique la date et/ou l'heure de création du média, au format ISO-8601. Il peut s'agir, par exemple, de la date et de l'heure auxquelles une photo a été prise ou d'un morceau de musique enregistré.

- (NSString* const) kGCKMetadataKeyReleaseDate

Clé de chaîne: date de sortie.

La valeur indique la date et/ou l'heure de publication du contenu multimédia, au format ISO-8601. Il peut s'agir, par exemple, de la date de sortie d'un film ou d'un album.

- (NSString* const) kGCKMetadataKeyBroadcastDate

Clé de chaîne: date de diffusion.

La valeur est la date et/ou l'heure de la première diffusion du média, au format ISO-8601. Il peut s'agir, par exemple, de la date de la première diffusion d'un épisode de série TV.

- (NSString* const) kGCKMetadataKeyTitle

Clé de chaîne: titre.

Titre du support. Il peut s'agir, par exemple, 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 support. 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 un album. Par exemple, dans des compilations telles que des mix de DJ, l'artiste de l'album n'est pas nécessairement le même que celui de l'artiste pour chaque titre. Cette valeur convient à des fins d'affichage.

- (NSString* const) kGCKMetadataKeyAlbumTitle

Clé de chaîne: titre de l'album.

Titre de l'album auquel appartient un titre musical. 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 (à partir de 1) auquel appartient un titre dans un album multidisque.

- (NSString* const) kGCKMetadataKeyTrackNumber

Clé de nombre entier: numéro de suivi.

Numéro du titre d'un disque d'album. Les numéros de titre sont généralement comptabilisés à partir de 1, mais cette valeur peut être égale à 0 si le titre est masqué au début de l'album.

- (NSString* const) kGCKMetadataKeySeasonNumber

Clé de nombre entier: numéro de saison.

Numéro de la saison à laquelle appartient un épisode de série TV. Les numéros de saison sont comptabilisés à partir de 1, mais cette valeur peut être égale à 0 s'il s'agit d'un épisode "pilote" antérieur au début officiel d'une série TV.

- (NSString* const) kGCKMetadataKeyEpisodeNumber

Clé entière: numéro d'épisode.

Nombre d'épisodes d'une saison d'une émission télévisée donnée. Les numéros d'épisode sont généralement comptabilisés à 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 émission télévisée 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 élément multimédia. Il peut s'agir, par exemple, du nom d'un studio de cinéma ou d'un label musical. Cette valeur convient à des fins d'affichage.

- (NSString* const) kGCKMetadataKeyWidth

Clé de l'entier: largeur.

Largeur d'un élément multimédia, en pixels. Il est généralement utilisé pour indiquer les dimensions d'une photo.

- (NSString* const) kGCKMetadataKeyHeight

Clé de nombre entier: hauteur.

Hauteur d'un élément multimédia, en pixels. Il est généralement utilisé pour indiquer les dimensions d'une photo.

- (NSString* const) kGCKMetadataKeyLocationName

Clé de chaîne: nom de l'emplacement.

Nom d'un emplacement où un média a été créé. Il peut s'agir, par exemple, du lieu de la prise de vue ou du lieu de tournage principal d'un film. Cette valeur convient à des fins d'affichage.

- (NSString* const) kGCKMetadataKeyLocationLatitude

Double clé: latitude de l'établissement.

Composant de latitude de la zone géographique dans laquelle un média a été créé. Il peut s'agir, par exemple, du lieu de la prise de vue ou du lieu de tournage principal d'un film.

- (NSString* const) kGCKMetadataKeyLocationLongitude

Double clé: longitude du lieu.

Composant de longitude de la zone géographique dans laquelle un média a été créé. Il peut s'agir, par exemple, du lieu de la prise de vue ou du lieu de tournage principal d'un film.

Détails de la propriété

- (GCKMediaMetadataType) metadataType

readnonatomicassign

Type de métadonnées.

Classe GCKMediaMetadata

Présentation

Résumé de la méthode d'instance

Attributs publics

Récapitulatif de la propriété

Détails sur la méthode

Documentation sur les données des membres

Détails de la propriété