Panoramica

Un contenitore per i metadati dei contenuti multimediali.

I metadati includono un tipo multimediale, un elenco facoltativo di immagini e una raccolta di campi di metadati. Le chiavi dei campi di metadati comuni sono predefinite come costanti, ma l'applicazione è libera di definire e utilizzare campi aggiuntivi.

I valori dei campi predefiniti hanno tipi predefiniti. Ad esempio, il numero di una traccia è NSInteger e la data di creazione è una NSString che contiene una rappresentazione ISO-8601 di una data e un'ora. Il tentativo di memorizzare un valore di tipo errato in un campo genererà un'eccezione NSInvalidArgumentException.

Tieni presente che il protocollo Cast limita i campi di metadati che possono essere utilizzati per un determinato tipo di contenuti multimediali. Quando un oggetto MediaMetadata viene serializzato in JSON per il caricamento a un ricevitore Cast, gli eventuali campi predefiniti non supportati per un determinato tipo di contenuti multimediali non verranno inclusi nel modulo serializzato, ma saranno sempre inclusi i campi definiti dall'applicazione. Di seguito è riportato l'elenco completo dei campi predefiniti:

Campo	Tipo di valore	Tipi di metadati validi
kGCKMetadataKeyCreationDate	NSDate	GCKMediaMetadataTypePhoto
kGCKMetadataKeyReleaseDate	NSDate	GCKMediaMetadataTypeGeneric, GCKMediaMetadataTypeMovie, GCKMediaMetadataTypeTVShow e GCKMediaMetadataTypeMusicTrack
kGCKMetadataKeyBroadcastDate	NSDate	GCKMediaMetadataTypeTVShow
kGCKMetadataKeyTitle	NSString	GCKMediaMetadataTypeGeneric, GCKMediaMetadataTypeMovie, GCKMediaMetadataTypeTVShow, GCKMediaMetadataTypeMusicTrack e GCKMediaMetadataTypePhoto
kGCKMetadataKeySubtitle	NSString	GCKMediaMetadataTypeGeneric, GCKMediaMetadataTypeMovie
kGCKMetadataKeyArtist	NSString	GCKMediaMetadataTypeGeneric, GCKMediaMetadataTypeMusicTrack e 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	doppio	GCKMediaMetadataTypePhoto
kGCKMetadataKeyLocationLongitude	doppio	GCKMediaMetadataTypePhoto

Eredita NSObject, <NSCOPY> e <NSSecureCoding>.

Riepilogo del metodo di istanza
(instancetype)	- initWithMetadataType:
	Inizializza un nuovo MediaMetadata vuoto con il tipo di supporto specificato. Altro...

(instancetype)	- init
	Inizializza con il tipo di metadati generico. Altro...

(GCKMediaMetadataType)	- metadataType
	Il tipo di metadati. Altro...

(NSArray *)	- images
	Restituisce l'elenco delle immagini. Altro...

(void)	- removeAllMediaImages
	Rimuove tutte le immagini correnti. Altro...

(void)	- addImage:
	Aggiunge un'immagine all'elenco di immagini. Altro...

(BOOL)	- containsKey:
	Verifica se l'oggetto contiene un campo con la chiave specificata. Altro...

(NSArray< NSString * > *)	- allKeys
	Restituisce un insieme di chiavi per tutti i campi presenti nell'oggetto. Altro...

(nullable id)	- objectForKey:
	Legge il valore di un campo. Altro...

(void)	- setString:forKey:
	Archivia un valore in un campo stringa. Altro...

(nullable NSString *)	- stringForKey:
	Legge il valore di un campo stringa. Altro...

(void)	- setInteger:forKey:
	Archivia un valore in un campo con numeri interi. Altro...

(NSInteger)	- integerForKey:
	Legge il valore di un campo con numeri interi. Altro...

(NSInteger)	- integerForKey:defaultValue:
	Legge il valore di un campo con numeri interi. Altro...

(void)	- setDouble:forKey:
	Memorizza un valore in un campo Double. Altro...

(double)	- doubleForKey:
	Legge il valore di un campo Double. Altro...

(double)	- doubleForKey:defaultValue:
	Legge il valore di un campo Double. Altro...

(void)	- setDate:forKey:
	Memorizza un valore in un campo data come rappresentazione ISO-8601 limitata della data. Altro...

(nullable NSDate *)	- dateForKey:
	Legge il valore di un campo data dalla rappresentazione limitata ISO-8601 della data. Altro...

(nullable NSString *)	- dateAsStringForKey:
	Legge il valore di un campo data, sotto forma di stringa. Altro...

Attributi pubblici
NSString *const	kGCKMetadataKeyCreationDate
	Chiave stringa: data di creazione. Altro...

NSString *const	kGCKMetadataKeyReleaseDate
	Chiave stringa: data di uscita. Altro...

NSString *const	kGCKMetadataKeyBroadcastDate
	Chiave stringa: data della trasmissione. Altro...

NSString *const	kGCKMetadataKeyTitle
	Chiave stringa: titolo. Altro...

NSString *const	kGCKMetadataKeySubtitle
	Chiave stringa: sottotitolo. Altro...

NSString *const	kGCKMetadataKeyArtist
	Chiave stringa: Artista. Altro...

NSString *const	kGCKMetadataKeyAlbumArtist
	Chiave stringa: l'artista dell'album. Altro...

NSString *const	kGCKMetadataKeyAlbumTitle
	Chiave stringa: titolo dell'album. Altro...

NSString *const	kGCKMetadataKeyComposer
	Chiave stringa: Composer. Altro...

NSString *const	kGCKMetadataKeyDiscNumber
	Chiave numero intero: numero del disco. Altro...

NSString *const	kGCKMetadataKeyTrackNumber
	Chiave numero intero: numero della traccia. Altro...

NSString *const	kGCKMetadataKeySeasonNumber
	Chiave numero intero: numero della stagione. Altro...

NSString *const	kGCKMetadataKeyEpisodeNumber
	Chiave numero intero: numero della puntata. Altro...

NSString *const	kGCKMetadataKeySeriesTitle
	Chiave stringa: titolo della serie. Altro...

NSString *const	kGCKMetadataKeyStudio
	Chiave stringa: Studio. Altro...

NSString *const	kGCKMetadataKeyWidth
	Chiave numero intero: larghezza. Altro...

NSString *const	kGCKMetadataKeyHeight
	Chiave numero intero: altezza. Altro...

NSString *const	kGCKMetadataKeyLocationName
	Chiave stringa: nome della località. Altro...

NSString *const	kGCKMetadataKeyLocationLatitude
	Tasto doppio: latitudine della posizione. Altro...

NSString *const	kGCKMetadataKeyLocationLongitude
	Chiave doppia: longitudine della posizione. Altro...

NSString *const	kGCKMetadataKeyBookTitle
	Chiave stringa: titolo del libro. Altro...

NSString *const	kGCKMetadataKeyChapterNumber
	Chiave numero intero: numero di capitolo. Altro...

NSString *const	kGCKMetadataKeyChapterTitle
	Chiave stringa: titolo del capitolo. Altro...

NSString *const	kGCKMetadataKeySectionDuration
	Chiave doppia: durata della sezione. Altro...

NSString *const	kGCKMetadataKeySectionStartTimeInMedia
	Tasto doppio: Ora di inizio della sezione nei contenuti multimediali. Altro...

NSString *const	kGCKMetadataKeySectionStartAbsoluteTime
	Tasto doppio: Ora di inizio assoluta della sezione. Altro...

NSString *const	kGCKMetadataKeySectionStartTimeInContainer
	Chiave doppia: ora di inizio della sezione nel container. Altro...

NSString *const	kGCKMetadataKeyQueueItemID
	Chiave doppia: ID elemento della coda. Altro...

Riepilogo proprietà
GCKMediaMetadataType	metadataType
	Il tipo di metadati. Altro...

Dettaglio metodo

- (instancetype) initWithMetadataType: (GCKMediaMetadataType) metadataType

Inizializza un nuovo MediaMetadata vuoto con il tipo di supporto specificato.

Inizializzatore designato.

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

Inizializza con il tipo di metadati generico.

- (GCKMediaMetadataType) metadataType

Il tipo di metadati.

- (NSArray *) images

Restituisce l'elenco delle immagini.

- (void) removeAllMediaImages

Rimuove tutte le immagini correnti.

- (void) addImage: (GCKImage *) image

Aggiunge un'immagine all'elenco di immagini.

Parameters

image The image to add.

- (BOOL) containsKey: (NSString *) key

Verifica se l'oggetto contiene un campo con la chiave specificata.

Parameters

key The key.

Ritorni: YES se il campo esiste, NO negli altri casi.

- (NSArray<NSString *> *) allKeys

Restituisce un insieme di chiavi per tutti i campi presenti nell'oggetto.

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

Legge il valore di un campo.

Parameters

key	The key for the field.

Ritorni: Il valore del campo o nil se il campo non è stato impostato.

- (void) setString:	(NSString *)	value
forKey:	(NSString *)	key

Archivia un valore in un campo stringa.

Parameters

value	The new value for the field.
key	The key for the field.

Eccezioni

NSInvalidArgumentException se la chiave si riferisce a un campo predefinito che non è un campo stringa.

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

Legge il valore di un campo stringa.

Parameters

key	The key for the field.

Ritorni: Il valore del campo o nil se il campo non è stato impostato.

Eccezioni

NSInvalidArgumentException se la chiave si riferisce a un campo predefinito che non è un campo stringa.

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

Archivia un valore in un campo con numeri interi.

Parameters

value	The new value for the field.
key	The key for the field.

Eccezioni

NSInvalidArgumentException se la chiave si riferisce a un campo predefinito che non è un campo con numeri interi.

- (NSInteger) integerForKey: (NSString *) key

Legge il valore di un campo con numeri interi.

Parameters

key	The key for the field.

Ritorni: Il valore del campo o 0 se il campo non è stato impostato.

Eccezioni

NSInvalidArgumentException se la chiave si riferisce a un campo predefinito che non è un campo con numeri interi.

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

Legge il valore di un campo con numeri interi.

Parameters

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

Ritorni: Il valore del campo o il valore predefinito fornito se il campo non è stato impostato.

Eccezioni

NSInvalidArgumentException se la chiave si riferisce a un campo predefinito che non è un campo con numeri interi.

- (void) setDouble:	(double)	value
forKey:	(NSString *)	key

Memorizza un valore in un campo Double.

Parameters

value	The new value for the field.
key	The key for the field.

Eccezioni

NSInvalidArgumentException se la chiave si riferisce a un campo predefinito che non è un campo doppio.

- (double) doubleForKey: (NSString *) key

Legge il valore di un campo Double.

Parameters

key	The key for the field.

Ritorni: Il valore del campo o 0 se il campo non è stato impostato.

Eccezioni

NSInvalidArgumentException se la chiave si riferisce a un campo predefinito che non è un campo doppio.

- (double) doubleForKey:	(NSString *)	key
defaultValue:	(double)	defaultValue

Legge il valore di un campo Double.

Parameters

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

Ritorni: Il valore del campo o il valore predefinito fornito se il campo non è stato impostato.

Eccezioni

NSInvalidArgumentException se la chiave si riferisce a un campo predefinito che non è un campo doppio.

- (void) setDate:	(NSDate *)	date
forKey:	(NSString *)	key

Memorizza un valore in un campo data come rappresentazione ISO-8601 limitata della data.

Parameters

date	The new value for the field.
key	The key for the field.

Eccezioni

NSInvalidArgumentException se la chiave si riferisce a un campo predefinito che non è un campo data.

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

Legge il valore di un campo data dalla rappresentazione limitata ISO-8601 della data.

Parameters

key	The field name.

Ritorni: La data o nil se questo campo non è stato impostato.

Eccezioni

NSInvalidArgumentException se la chiave si riferisce a un campo predefinito che non è un campo data.

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

Legge il valore di un campo data, sotto forma di stringa.

Parameters

key	The field name.

Ritorni: Data come stringa contenente la rappresentazione ISO-8601 limitata della data oppure nil se questo campo non è stato impostato.

Eccezioni

NSInvalidArgumentException se la chiave si riferisce a un campo predefinito che non è un campo data.

Documentazione relativa ai dati dei membri

- (NSString* const) kGCKMetadataKeyCreationDate

Chiave stringa: data di creazione.

Il valore è la data e/o l'ora in cui il supporto è stato creato, in formato ISO-8601. ad esempio la data e l'ora in cui è stata scattata una foto o è stato registrato un brano musicale.

- (NSString* const) kGCKMetadataKeyReleaseDate

Chiave stringa: data di uscita.

Il valore è la data e/o l'ora in cui i contenuti multimediali sono stati pubblicati, in formato ISO-8601. Ad esempio, la data di uscita di un film o di un album musicale.

- (NSString* const) kGCKMetadataKeyBroadcastDate

Chiave stringa: data della trasmissione.

Il valore è la data e/o l'ora in cui il contenuto multimediale è stato trasmesso per la prima volta, in formato ISO-8601. Ad esempio, potrebbe essere la data in cui l'episodio di un programma TV è stato trasmesso per la prima volta.

- (NSString* const) kGCKMetadataKeyTitle

Chiave stringa: titolo.

Il titolo del contenuto multimediale. ad esempio il titolo di una canzone, di un film o di un episodio di un programma TV. Questo valore è adatto per la visualizzazione.

- (NSString* const) kGCKMetadataKeySubtitle

Chiave stringa: sottotitolo.

Il sottotitolo dei contenuti multimediali. Questo valore è adatto per la visualizzazione.

- (NSString* const) kGCKMetadataKeyArtist

Chiave stringa: Artista.

Il nome dell'artista che ha creato i contenuti multimediali. Ad esempio, potrebbe essere il nome di un musicista, artista o fotografo. Questo valore è adatto per la visualizzazione.

- (NSString* const) kGCKMetadataKeyAlbumArtist

Chiave stringa: l'artista dell'album.

Il nome dell'artista che ha prodotto un album. Ad esempio, nelle compilation come i DJ set, l'artista dell'album non corrisponde necessariamente agli artisti delle singole canzoni dell'album. Questo valore è adatto per la visualizzazione.

- (NSString* const) kGCKMetadataKeyAlbumTitle

Chiave stringa: titolo dell'album.

Il titolo dell'album a cui appartiene una traccia musicale. Questo valore è adatto per la visualizzazione.

- (NSString* const) kGCKMetadataKeyComposer

Chiave stringa: Composer.

Il nome del compositore di una traccia musicale. Questo valore è adatto per la visualizzazione.

- (NSString* const) kGCKMetadataKeyDiscNumber

Chiave numero intero: numero del disco.

Il numero del disco (calcolato a partire da 1) a cui appartiene una traccia musicale in un album multidisco.

- (NSString* const) kGCKMetadataKeyTrackNumber

Chiave numero intero: numero della traccia.

Il numero di una traccia musicale sul disco di un album. In genere i numeri delle tracce vengono conteggiati partendo da 1; tuttavia, questo valore può essere pari a 0 se si tratta di una "traccia nascosta" all'inizio di un album.

- (NSString* const) kGCKMetadataKeySeasonNumber

Chiave numero intero: numero della stagione.

Il numero della stagione a cui appartiene l'episodio di un programma TV. In genere i numeri delle stagioni vengono conteggiati partendo da 1, tuttavia questo valore può essere 0 se si tratta di un episodio "pilota" precedente all'inizio ufficiale di una serie TV.

- (NSString* const) kGCKMetadataKeyEpisodeNumber

Chiave numero intero: numero della puntata.

Il numero di una puntata di una determinata stagione di un programma TV. In genere i numeri degli episodi vengono conteggiati partendo da 1, tuttavia questo valore può essere 0 se si tratta di un episodio "pilota" che non è considerato un episodio ufficiale della prima stagione.

- (NSString* const) kGCKMetadataKeySeriesTitle

Chiave stringa: titolo della serie.

Il nome di una serie. Ad esempio, potrebbe trattarsi del nome di un programma TV o di una serie di album musicali correlati. Questo valore è adatto per la visualizzazione.

- (NSString* const) kGCKMetadataKeyStudio

Chiave stringa: Studio.

Il nome di uno studio di registrazione che ha prodotto un supporto. Ad esempio, potrebbe essere il nome di uno studio cinematografico o di una casa discografica. Questo valore è adatto per la visualizzazione.

- (NSString* const) kGCKMetadataKeyWidth

Chiave numero intero: larghezza.

La larghezza di un elemento multimediale, in pixel. In genere viene utilizzato per fornire le dimensioni di una fotografia.

- (NSString* const) kGCKMetadataKeyHeight

Chiave numero intero: altezza.

L'altezza di un elemento multimediale, in pixel. In genere viene utilizzato per fornire le dimensioni di una fotografia.

- (NSString* const) kGCKMetadataKeyLocationName

Chiave stringa: nome della località.

Il nome di una posizione in cui è stato creato un elemento multimediale. Ad esempio, potrebbe trattarsi del luogo in cui si trova una fotografia o del luogo in cui è stata girata la scena principale di un film. Questo valore è adatto per la visualizzazione.

- (NSString* const) kGCKMetadataKeyLocationLatitude

Tasto doppio: latitudine della posizione.

Il componente della latitudine della posizione geografica in cui è stato creato un elemento multimediale. Ad esempio, potrebbe trattarsi del luogo in cui si trova una fotografia o del luogo in cui è stata girata la scena principale di un film.

- (NSString* const) kGCKMetadataKeyLocationLongitude

Chiave doppia: longitudine della posizione.

Il componente della longitudine della posizione geografica in cui è stato creato un elemento multimediale. Ad esempio, potrebbe trattarsi del luogo in cui si trova una fotografia o del luogo in cui è stata girata la scena principale di un film.

- (NSString* const) kGCKMetadataKeyBookTitle

Chiave stringa: titolo del libro.

Il titolo di un audiolibro.

Dal: 4.3.5

- (NSString* const) kGCKMetadataKeyChapterNumber

Chiave numero intero: numero di capitolo.

Il numero di un capitolo di un audiolibro.

Dal: 4.3.5

- (NSString* const) kGCKMetadataKeyChapterTitle

Chiave stringa: titolo del capitolo.

Il titolo di un capitolo di un audiolibro.

Dal: 4.3.5

- (NSString* const) kGCKMetadataKeySectionDuration

Chiave doppia: durata della sezione.

La durata della sezione in secondi. Utilizzato per i metadati della coda. ad esempio la durata di un programma TV in coda, la durata di un capitolo di un audiolibro o un programma di un lungo live streaming.

Dal: 4.4.1

- (NSString* const) kGCKMetadataKeySectionStartTimeInMedia

Tasto doppio: Ora di inizio della sezione nei contenuti multimediali.

L'offset dell'ora di inizio della sezione dall'inizio dell'elemento multimediale in secondi. Utilizzato per i metadati della coda.

Dal: 4.4.1

- (NSString* const) kGCKMetadataKeySectionStartAbsoluteTime

Tasto doppio: Ora di inizio assoluta della sezione.

Il tempo assoluto di inizio della sezione, espresso in secondi. Utilizzato per i metadati della coda.

Dal: 4.4.1

- (NSString* const) kGCKMetadataKeySectionStartTimeInContainer

Chiave doppia: ora di inizio della sezione nel container.

L'offset dell'ora di inizio della sezione all'interno del container completo. Utilizzato per i metadati della coda.

Dal: 4.4.1

- (NSString* const) kGCKMetadataKeyQueueItemID

Chiave doppia: ID elemento della coda.

L'ID dell'elemento della coda che include l'ora di inizio della sezione. Utilizzato per i metadati della coda.

Dal: 4.4.1

Dettagli della proprietà

- (GCKMediaMetadataType) metadataType

readnonatomicassign

Il tipo di metadati.

Classe GCKMediaMetadata

Panoramica

Riepilogo del metodo di istanza

Attributi pubblici

Riepilogo proprietà

Dettaglio metodo

Documentazione relativa ai dati dei membri

Dettagli della proprietà