Classe GCKMediaMetadata

Riferimento alla classe GCKMediaMetadata

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

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

Parameters
keyThe 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
keyThe 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
valueThe new value for the field.
keyThe key for the field.
Eccezioni
NSInvalidArgumentExceptionse 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
keyThe key for the field.
Ritorni
Il valore del campo o nil se il campo non è stato impostato.
Eccezioni
NSInvalidArgumentExceptionse 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
valueThe new value for the field.
keyThe key for the field.
Eccezioni
NSInvalidArgumentExceptionse 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
keyThe key for the field.
Ritorni
Il valore del campo o 0 se il campo non è stato impostato.
Eccezioni
NSInvalidArgumentExceptionse 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
keyThe key for the field.
defaultValueThe 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
NSInvalidArgumentExceptionse 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
valueThe new value for the field.
keyThe key for the field.
Eccezioni
NSInvalidArgumentExceptionse 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
keyThe key for the field.
Ritorni
Il valore del campo o 0 se il campo non è stato impostato.
Eccezioni
NSInvalidArgumentExceptionse 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
defaultValueThe value to return if the field has not been set.
keyThe key for the field.
Ritorni
Il valore del campo o il valore predefinito fornito se il campo non è stato impostato.
Eccezioni
NSInvalidArgumentExceptionse 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
dateThe new value for the field.
keyThe key for the field.
Eccezioni
NSInvalidArgumentExceptionse 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
keyThe field name.
Ritorni
La data o nil se questo campo non è stato impostato.
Eccezioni
NSInvalidArgumentExceptionse 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
keyThe field name.
Ritorni
Data come stringa contenente la rappresentazione ISO-8601 limitata della data oppure nil se questo campo non è stato impostato.
Eccezioni
NSInvalidArgumentExceptionse 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.