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:
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à
|
readnonatomicassign |
Il tipo di metadati.