Panoramica
Un contenitore per i metadati dei contenuti multimediali.
I metadati hanno 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 altri campi propri.
I valori dei campi predefiniti sono di tipo predefinito. Ad esempio, un numero di traccia è NSInteger e una data di creazione è una NSString contenente una rappresentazione ISO-8601 di data e ora. Quando si tenta di memorizzare un valore di tipo non corretto in un campo, verrà sollevata una NSInvalidArgumentException.
Tieni presente che il protocollo di trasmissione limita i campi di metadati che possono essere utilizzati per un determinato tipo di contenuti multimediali. Quando un oggetto MediaMetadata viene serializzato su JSON per essere consegnato a un ricevitore Cast, tutti i campi predefiniti che non sono supportati per un determinato tipo multimediale non verranno inclusi nella forma serializzata, ma tutti i campi definiti dall'applicazione verranno sempre inclusi. Di seguito è riportato l'elenco completo dei campi predefiniti:
Eredita NSObject. Implementa la funzionalità <NSCopia>.
Riepilogo del metodo dell'istanza | |
| (instancetype) | - initWithMetadataType: |
| Inizializza un nuovo MediaMetadata vuoto con il tipo di contenuto specificato. Altro... | |
| (instancetype) | - init |
| Inizializza con il tipo di metadati generico. Altro... | |
| (GCKMediaMetadataType) | - metadataType |
| Il tipo di metadati. Altro... | |
| (NSArray *) | - images |
| Visualizza l'elenco di 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... | |
| (id __nullable) | - objectForKey: |
| Legge il valore di un campo. Altro... | |
| (void) | - setString:forKey: |
| Archivia un valore in un campo stringa. Altro... | |
| (NSString *__nullable) | - stringForKey: |
| Legge il valore di un campo stringa. Altro... | |
| (void) | - setInteger:forKey: |
| Archivia un valore in un campo numero intero. Altro... | |
| (NSInteger) | - integerForKey: |
| Legge il valore di un campo numero intero. Altro... | |
| (NSInteger) | - integerForKey:defaultValue: |
| Legge il valore di un campo numero intero. Altro... | |
| (void) | - setDouble:forKey: |
| Archivia un valore in un campo doppio. 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: |
| Archivia un valore in un campo di data come rappresentazione limitata ISO-8601 della data. Altro... | |
| (NSDate *__nullable) | - dateForKey: |
| Legge il valore di un campo data dalla rappresentazione ISO-8601 limitata della data. Altro... | |
| (NSString *__nullable) | - dateAsStringForKey: |
| Legge il valore di un campo data come stringa. Altro... | |
Attributi pubblici | |
| NSString *const | kGCKMetadataKeyCreationDate |
| Chiave della stringa: data di creazione. Altro... | |
| NSString *const | kGCKMetadataKeyReleaseDate |
| Chiave della stringa: data di uscita. Altro... | |
| NSString *const | kGCKMetadataKeyBroadcastDate |
| Chiave della stringa: data di trasmissione. Altro... | |
| NSString *const | kGCKMetadataKeyTitle |
| Chiave della stringa: titolo. Altro... | |
| NSString *const | kGCKMetadataKeySubtitle |
| Chiave della stringa: sottotitolo. Altro... | |
| NSString *const | kGCKMetadataKeyArtist |
| Chiave della stringa: artista. Altro... | |
| NSString *const | kGCKMetadataKeyAlbumArtist |
| Chiave di stringa: artista dell'album. Altro... | |
| NSString *const | kGCKMetadataKeyAlbumTitle |
| Chiave di stringa: titolo dell'album. Altro... | |
| NSString *const | kGCKMetadataKeyComposer |
| Chiave della stringa: Composer. Altro... | |
| NSString *const | kGCKMetadataKeyDiscNumber |
| Chiave in numeri interi: numero del disco. Altro... | |
| NSString *const | kGCKMetadataKeyTrackNumber |
| Chiave in numeri interi: numero della traccia. Altro... | |
| NSString *const | kGCKMetadataKeySeasonNumber |
| Chiave in numeri interi: numero di stagione. Altro... | |
| NSString *const | kGCKMetadataKeyEpisodeNumber |
| Chiave in numeri interi: numero della puntata. Altro... | |
| NSString *const | kGCKMetadataKeySeriesTitle |
| Chiave della stringa: titolo della serie. Altro... | |
| NSString *const | kGCKMetadataKeyStudio |
| Chiave della stringa: Studio. Altro... | |
| NSString *const | kGCKMetadataKeyWidth |
| Chiave in numeri interi: Larghezza. Altro... | |
| NSString *const | kGCKMetadataKeyHeight |
| Chiave in numeri interi: altezza. Altro... | |
| NSString *const | kGCKMetadataKeyLocationName |
| Chiave della stringa: nome della posizione. Altro... | |
| NSString *const | kGCKMetadataKeyLocationLatitude |
| Tasto doppio: latitudine località. Altro... | |
| NSString *const | kGCKMetadataKeyLocationLongitude |
| Tasto doppio: longitudine della sede. 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 contenuto 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 |
Visualizza l'elenco di 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.
- Valori restituiti
YESse il campo esiste, altrimentiNO.
| - (NSArray<NSString *> *) allKeys |
Restituisce un insieme di chiavi per tutti i campi presenti nell'oggetto.
| - (id __nullable) objectForKey: | (NSString *) | key |
Legge il valore di un campo.
- Parameters
-
key The key for the field.
- Valori restituiti
- Il valore del campo o
nilse 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
-
Eccezione NSinvalidArgument se la chiave si riferisce a un campo predefinito che non è un campo stringa.
| - (NSString *__nullable) stringForKey: | (NSString *) | key |
Legge il valore di un campo stringa.
- Parameters
-
key The key for the field.
- Valori restituiti
- Il valore del campo o
nilse il campo non è stato impostato.
- Eccezioni
-
Eccezione NSinvalidArgument 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 numero intero.
- Parameters
-
value The new value for the field. key The key for the field.
- Eccezioni
-
Eccezione NSinvalidArgument se la chiave si riferisce a un campo predefinito che non è un campo numero intero.
| - (NSInteger) integerForKey: | (NSString *) | key |
Legge il valore di un campo numero intero.
- Parameters
-
key The key for the field.
- Valori restituiti
- Il valore del campo o 0 se il campo non è stato impostato.
- Eccezioni
-
Eccezione NSinvalidArgument se la chiave si riferisce a un campo predefinito che non è un campo numero intero.
| - (NSInteger) integerForKey: | (NSString *) | key | |
| defaultValue: | (NSInteger) | defaultValue | |
Legge il valore di un campo numero intero.
- Parameters
-
key The key for the field. defaultValue The value to return if the field has not been set.
- Valori restituiti
- Il valore del campo o il valore predefinito specificato se il campo non è stato impostato.
- Eccezioni
-
Eccezione NSinvalidArgument se la chiave si riferisce a un campo predefinito che non è un campo numero intero.
| - (void) setDouble: | (double) | value | |
| forKey: | (NSString *) | key | |
Archivia un valore in un campo doppio.
- Parameters
-
value The new value for the field. key The key for the field.
- Eccezioni
-
Eccezione NSinvalidArgument 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.
- Valori restituiti
- Il valore del campo o 0 se il campo non è stato impostato.
- Eccezioni
-
Eccezione NSinvalidArgument 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.
- Valori restituiti
- Il valore del campo o il valore predefinito specificato se il campo non è stato impostato.
- Eccezioni
-
Eccezione NSinvalidArgument se la chiave si riferisce a un campo predefinito che non è un campo doppio.
| - (void) setDate: | (NSDate *) | date | |
| forKey: | (NSString *) | key | |
Archivia un valore in un campo di data come rappresentazione limitata ISO-8601 della data.
- Parameters
-
date The new value for the field. key The key for the field.
- Eccezioni
-
Eccezione NSinvalidArgument se la chiave si riferisce a un campo predefinito che non è un campo data.
| - (NSDate *__nullable) dateForKey: | (NSString *) | key |
Legge il valore di un campo data dalla rappresentazione ISO-8601 limitata della data.
- Parameters
-
key The field name.
- Valori restituiti
- La data o
nilse questo campo non è stato impostato.
- Eccezioni
-
Eccezione NSinvalidArgument se la chiave si riferisce a un campo predefinito che non è un campo data.
| - (NSString *__nullable) dateAsStringForKey: | (NSString *) | key |
Legge il valore di un campo data come stringa.
- Parameters
-
key The field name.
- Valori restituiti
- La data come stringa contenente la rappresentazione ISO-8601 limitata della data oppure
nilse questo campo non è stato impostato.
- Eccezioni
-
Eccezione NSinvalidArgument se la chiave si riferisce a un campo predefinito che non è un campo data.
Documentazione dei dati dei membri
| - (NSString* const) kGCKMetadataKeyCreationDate |
Chiave della stringa: data di creazione.
Il valore corrisponde alla data e/o all'ora in cui è stato creato il supporto, in formato ISO-8601. Ad esempio, potrebbe essere la data e l'ora in cui è stata scattata una foto o in cui è stata registrata una musica.
| - (NSString* const) kGCKMetadataKeyReleaseDate |
Chiave della stringa: data di uscita.
Il valore è la data e/o l'ora in cui il supporto è stato rilasciato, in formato ISO-8601. Ad esempio, potrebbe essere la data di uscita di un film o album musicale.
| - (NSString* const) kGCKMetadataKeyBroadcastDate |
Chiave della stringa: data di trasmissione.
Il valore corrisponde alla data e/o all'ora in cui i contenuti multimediali sono stati trasmessi per la prima volta, in formato ISO-8601. Potrebbe, ad esempio, corrispondere alla data in cui la prima puntata di un programma TV è stata trasmessa.
| - (NSString* const) kGCKMetadataKeyTitle |
Chiave della stringa: titolo.
Il titolo del contenuto multimediale. Ad esempio, può essere il titolo di una canzone, un film o un episodio di un programma TV. Questo valore è adatto ai fini della visualizzazione.
| - (NSString* const) kGCKMetadataKeySubtitle |
Chiave della stringa: sottotitolo.
Il sottotitolo dei contenuti multimediali. Questo valore è adatto ai fini della visualizzazione.
| - (NSString* const) kGCKMetadataKeyArtist |
Chiave della stringa: artista.
Il nome dell'artista che ha creato i contenuti multimediali. Potrebbe essere, ad esempio, il nome di un musicista, di un artista o di un fotografo. Questo valore è adatto ai fini della visualizzazione.
| - (NSString* const) kGCKMetadataKeyAlbumArtist |
Chiave di stringa: artista dell'album.
Il nome dell'artista che ha prodotto un album. Ad esempio, nelle compilation come i DJ set, l'artista non corrisponde necessariamente agli artisti delle singole canzoni presenti nell'album. Questo valore è adatto ai fini della visualizzazione.
| - (NSString* const) kGCKMetadataKeyAlbumTitle |
Chiave di stringa: titolo dell'album.
Il titolo dell'album a cui appartiene una traccia musicale. Questo valore è adatto ai fini della visualizzazione.
| - (NSString* const) kGCKMetadataKeyComposer |
Chiave della stringa: Composer.
Il nome del compositore di una traccia musicale. Questo valore è adatto ai fini della visualizzazione.
| - (NSString* const) kGCKMetadataKeyDiscNumber |
Chiave in numeri interi: numero del disco.
Il numero del disco (contando da 1) a cui appartiene una traccia musicale in un album con più dischi.
| - (NSString* const) kGCKMetadataKeyTrackNumber |
Chiave in numeri interi: numero della traccia.
Il numero del brano di un brano di un disco dell'album. In genere i numeri delle tracce vengono conteggiati a partire da 1; tuttavia, questo valore potrebbe essere 0 se si tratta di una "traccia nascosta" all'inizio di un album.
| - (NSString* const) kGCKMetadataKeySeasonNumber |
Chiave in numeri interi: numero di stagione.
Il numero della stagione a cui appartiene una puntata di un programma TV. In genere i numeri delle stagioni vengono conteggiati a partire da 1, ma questo valore potrebbe essere 0 se si tratta di una puntata "pilota" precedente all'inizio ufficiale di una serie TV.
| - (NSString* const) kGCKMetadataKeyEpisodeNumber |
Chiave in numeri interi: numero della puntata.
Il numero di una puntata in una determinata stagione di un programma TV. In genere i numeri delle puntate vengono conteggiati a partire da 1; tuttavia, questo valore potrebbe essere 0 se si tratta di una puntata "pilota" che non è considerata una puntata ufficiale della prima stagione.
| - (NSString* const) kGCKMetadataKeySeriesTitle |
Chiave della stringa: titolo della serie.
Il nome di una serie. Potrebbe essere, ad esempio, il nome di un programma TV o di una serie di album musicali correlati. Questo valore è adatto ai fini della visualizzazione.
| - (NSString* const) kGCKMetadataKeyStudio |
Chiave della stringa: Studio.
Il nome di uno studio di registrazione che ha prodotto un contenuto multimediale. Potrebbe essere, ad esempio, il nome di uno studio cinematografico o di una casa discografica. Questo valore è adatto ai fini della visualizzazione.
| - (NSString* const) kGCKMetadataKeyWidth |
Chiave in numeri interi: Larghezza.
La larghezza di un elemento multimediale, in pixel. Questa opzione viene generalmente utilizzata per fornire le dimensioni di una fotografia.
| - (NSString* const) kGCKMetadataKeyHeight |
Chiave in numeri interi: altezza.
L'altezza di un supporto multimediale, in pixel. Questa opzione viene generalmente utilizzata per fornire le dimensioni di una fotografia.
| - (NSString* const) kGCKMetadataKeyLocationName |
Chiave della stringa: nome della posizione.
Il nome di una località in cui è stato creato un elemento multimediale. Ad esempio, può essere la posizione di una fotografia o la location principale di un film. Questo valore è adatto ai fini della visualizzazione.
| - (NSString* const) kGCKMetadataKeyLocationLatitude |
Tasto doppio: latitudine località.
Il componente latitudine della posizione geografica in cui è stato creato un elemento multimediale. Ad esempio, può essere la posizione di una fotografia o la location principale di un film.
| - (NSString* const) kGCKMetadataKeyLocationLongitude |
Tasto doppio: longitudine della sede.
Il componente della longitudine della posizione geografica in cui è stato creato un supporto. Ad esempio, può essere la posizione di una fotografia o la location principale di un film.
Dettaglio proprietà
|
readnonatomicassign |
Il tipo di metadati.