Présentation

Conteneur pour les métadonnées média.

Les métadonnées comportent un type de contenu multimédia, une liste d'images facultative et une collection 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 un NSString contenant une représentation ISO-8601 d'une date et d'une heure. Toute tentative de stockage d'une valeur de 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é au format JSON pour être envoyé à un récepteur Cast, tous les champs prédéfinis qui ne sont pas compatibles avec un type de contenu multimédia donné ne sont pas inclus dans la forme sérialisée, 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. Implémente <NSCopying>.

Récapitulatif des méthodes d'instance
(instancetype)	- initWithMetadataType:
	Initialise un nouvel objet MediaMetadata vide avec le type de contenu multimédia spécifié. 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 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'entiers. Plus

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

(NSInteger)	- integerForKey:defaultValue:
	Lit la valeur d'un champ 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 : Title. Plus

NSString *const	kGCKMetadataKeySubtitle
	Clé de chaîne : Subtitle. Plus

NSString *const	kGCKMetadataKeyArtist
	Clé de chaîne : "Artist". 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 piste. Plus

NSString *const	kGCKMetadataKeySeasonNumber
	Clé entière : numéro de la saison. Plus

NSString *const	kGCKMetadataKeyEpisodeNumber
	Clé de type entier : 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é de nombre entier : "Width" (Largeur). Plus

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

NSString *const	kGCKMetadataKeyLocationName
	Clé de chaîne : nom du lieu. Plus

NSString *const	kGCKMetadataKeyLocationLatitude
	Clé double : latitude du lieu. Plus

NSString *const	kGCKMetadataKeyLocationLongitude
	Clé double : longitude du lieu. Plus

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

Détails sur la méthode

- (instancetype) initWithMetadataType: (GCKMediaMetadataType) metadataType

Initialise un nouvel objet MediaMetadata vide avec le type de contenu multimédia spécifié.

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

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.

- (id __nullable) 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 chaîne.

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

Lit la valeur d'un champ de 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 chaîne.

- (void) setInteger:	(NSInteger)	value
forKey:	(NSString *)	key

Stocke une valeur dans un champ d'entiers.

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 entier.

- (NSInteger) integerForKey: (NSString *) key

Lit la valeur d'un champ 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 entier.

- (NSInteger) integerForKey:	(NSString *)	key
defaultValue:	(NSInteger)	defaultValue

Lit la valeur d'un champ 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 indiqué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 entier.

- (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 indiqué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.

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.

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

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

Parameters

key	The field name.

Renvoie: La date sous forme de chaîne contenant la représentation ISO-8601 restreinte de la date, ou; si ce champ n'a pas été défini.nil

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 correspond à la date et/ou à l'heure de création du contenu multimédia, au format ISO-8601. Par exemple, il peut s'agir de la date et de l'heure auxquelles une photo a été prise ou un morceau de musique a été enregistré.

- (NSString* const) kGCKMetadataKeyReleaseDate

Clé de chaîne : date de sortie.

La valeur correspond à la date et/ou à l'heure de sortie du contenu multimédia, au format ISO-8601. Par exemple, il peut s'agir de la date de sortie d'un film ou d'un album de musique.

- (NSString* const) kGCKMetadataKeyBroadcastDate

Clé de chaîne : date de diffusion.

La valeur correspond à la date et/ou à l'heure de la première diffusion du contenu multimédia, au format ISO-8601. Par exemple, il peut s'agir de la date de la première diffusion d'un épisode d'une série télévisée.

- (NSString* const) kGCKMetadataKeyTitle

Clé de chaîne : Title.

Titre du mé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 : Subtitle.

Sous-titre du contenu multimédia. Cette valeur convient à des fins d'affichage.

- (NSString* const) kGCKMetadataKeyArtist

Clé de chaîne : "Artist".

Nom de l'artiste qui a créé le contenu multimédia. Par exemple, il peut s'agir 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 les albums de compilation tels que les mix DJ, l'artiste de l'album 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 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 du disque (à partir de 1) auquel appartient un titre de musique dans un album multi-disques.

- (NSString* const) kGCKMetadataKeyTrackNumber

Clé entière : numéro de piste.

Numéro de piste d'un titre musical sur un album. En général, les numéros de piste sont comptés à partir de 1. Toutefois, cette valeur peut être égale à 0 s'il s'agit d'une "piste cachée" au début d'un album.

- (NSString* const) kGCKMetadataKeySeasonNumber

Clé entière : numéro de la saison.

Numéro de la saison à laquelle appartient l'épisode d'une série TV. En général, les numéros de saison commencent à 1. Toutefois, cette valeur peut être définie sur 0 s'il s'agit d'un épisode pilote qui précède le début officiel d'une série télévisée.

- (NSString* const) kGCKMetadataKeyEpisodeNumber

Clé de type entier : numéro de l'épisode.

Numéro d'un épisode dans une saison donnée d'une série télévisée. En règle générale, les numéros d'épisode commencent à 1. Toutefois, 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. Par exemple, il peut s'agir du nom d'une série TV ou d'une série d'albums de musique 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 contenu multimédia. Par exemple, il peut s'agir 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é de nombre entier : "Width" (Largeur).

Largeur d'un élément multimédia, en pixels. Cette propriété est généralement utilisée pour fournir les dimensions d'une photographie.

- (NSString* const) kGCKMetadataKeyHeight

Clé de nombre entier : hauteur.

Hauteur d'un élément multimédia, en pixels. Cette propriété est généralement utilisée pour fournir les dimensions d'une photographie.

- (NSString* const) kGCKMetadataKeyLocationName

Clé de chaîne : nom du lieu.

Nom d'un lieu où un élément multimédia a été créé. Par exemple, il peut s'agir du lieu où une photo a été prise 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 de latitude de l'emplacement géographique où un élément multimédia a été créé. Par exemple, il peut s'agir du lieu où une photo a été prise 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éé. Par exemple, il peut s'agir du lieu où une photo a été prise 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 Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Présentation

Récapitulatif des méthodes d'instance

Attributs publics

Récapitulatif des propriétés

Détails sur la méthode

Documentation sur les données des membres

Détails de la propriété

Classe GCKMediaMetadata