Panoramica
Un contenitore per i metadati dei contenuti multimediali.
I metadati hanno un tipo di media, un elenco facoltativo di immagini e una raccolta di campi di metadati. Le chiavi per i campi di metadati comuni sono predefinite come costanti, ma l'applicazione è libera di definire e utilizzare campi aggiuntivi propri.
I valori dei campi predefiniti hanno tipi predefiniti. Ad esempio, un numero di traccia è un NSInteger e una data di creazione è un NSString contenente 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 dei metadati che possono essere utilizzati per un determinato tipo di media. Quando un oggetto MediaMetadata viene serializzato in JSON per la distribuzione a un ricevitore Cast, tutti i campi predefiniti non supportati per un determinato tipo di media non vengono inclusi nel modulo serializzato, ma tutti i campi definiti dall'applicazione vengono sempre inclusi. Di seguito è riportato l'elenco completo dei campi predefiniti:
Eredita NSObject. Implementa <NSCopying>.
Riepilogo del metodo dell'istanza | |
| (instancetype) | - initWithMetadataType: |
| Inizializza un nuovo MediaMetadata vuoto con il tipo di contenuti multimediali specificato. Altro… | |
| (instancetype) | - init |
| Inizializza con il tipo di metadati generici. Altro… | |
| (GCKMediaMetadataType) | - metadataType |
| Il tipo di metadati. Altro… | |
| (NSArray *) | - images |
| Recupera l'elenco delle immagini. Altro… | |
| (void) | - removeAllMediaImages |
| Rimuove tutte le immagini attuali. Altro… | |
| (void) | - addImage: |
| Aggiunge un'immagine all'elenco delle 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: |
| Memorizza un valore in un campo stringa. Altro… | |
| (NSString *__nullable) | - stringForKey: |
| Legge il valore di un campo stringa. Altro… | |
| (void) | - setInteger:forKey: |
| Memorizza un valore in un campo intero. Altro… | |
| (NSInteger) | - integerForKey: |
| Legge il valore di un campo intero. Altro… | |
| (NSInteger) | - integerForKey:defaultValue: |
| Legge il valore di un campo intero. 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… | |
| (NSDate *__nullable) | - dateForKey: |
| Legge il valore di un campo data dalla rappresentazione ISO-8601 con limitazioni della data. Altro… | |
| (NSString *__nullable) | - dateAsStringForKey: |
| Legge il valore di un campo data come stringa. Altro… | |
Attributi pubblici | |
| NSString *const | kGCKMetadataKeyCreationDate |
| Chiave stringa: data di creazione. Altro… | |
| NSString *const | kGCKMetadataKeyReleaseDate |
| Chiave della stringa: data di uscita. Altro… | |
| NSString *const | kGCKMetadataKeyBroadcastDate |
| Chiave stringa: data di trasmissione. Altro… | |
| NSString *const | kGCKMetadataKeyTitle |
| Chiave della stringa: Titolo. Altro… | |
| NSString *const | kGCKMetadataKeySubtitle |
| Chiave stringa: Subtitle. Altro… | |
| NSString *const | kGCKMetadataKeyArtist |
| Chiave della stringa: Artista. Altro… | |
| NSString *const | kGCKMetadataKeyAlbumArtist |
| Chiave stringa: Album artist. Altro… | |
| NSString *const | kGCKMetadataKeyAlbumTitle |
| Chiave stringa: titolo dell'album. Altro… | |
| NSString *const | kGCKMetadataKeyComposer |
| Chiave stringa: Composer. Altro… | |
| NSString *const | kGCKMetadataKeyDiscNumber |
| Chiave intera: numero del disco. Altro… | |
| NSString *const | kGCKMetadataKeyTrackNumber |
| Chiave intera: numero della traccia. Altro… | |
| NSString *const | kGCKMetadataKeySeasonNumber |
| Chiave intera: numero della stagione. Altro… | |
| NSString *const | kGCKMetadataKeyEpisodeNumber |
| Chiave intera: numero della puntata. Altro… | |
| NSString *const | kGCKMetadataKeySeriesTitle |
| Chiave stringa: titolo della serie. Altro… | |
| NSString *const | kGCKMetadataKeyStudio |
| Chiave stringa: Studio. Altro… | |
| NSString *const | kGCKMetadataKeyWidth |
| Chiave intera: Larghezza. Altro… | |
| NSString *const | kGCKMetadataKeyHeight |
| Chiave intera: altezza. Altro… | |
| NSString *const | kGCKMetadataKeyLocationName |
| Chiave stringa: nome della località. Altro… | |
| NSString *const | kGCKMetadataKeyLocationLatitude |
| Chiave doppia: latitudine della località. Altro… | |
| NSString *const | kGCKMetadataKeyLocationLongitude |
| Chiave doppia: longitudine della località. Altro… | |
Riepilogo della proprietà | |
| GCKMediaMetadataType | metadataType |
| Il tipo di metadati. Altro… | |
Dettagli metodo
| - (instancetype) initWithMetadataType: | (GCKMediaMetadataType) | metadataType |
Inizializza un nuovo MediaMetadata vuoto con il tipo di contenuti multimediali 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 generici.
| - (GCKMediaMetadataType) metadataType |
Il tipo di metadati.
| - (NSArray *) images |
Recupera l'elenco delle immagini.
| - (void) removeAllMediaImages |
Rimuove tutte le immagini attuali.
| - (void) addImage: | (GCKImage *) | image |
Aggiunge un'immagine all'elenco delle 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.
- Resi
YESse il campo esiste,NOaltrimenti.
| - (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.
- Resi
- Il valore del campo o
nilse il campo non è stato impostato.
| - (void) setString: | (NSString *) | value | |
| forKey: | (NSString *) | key | |
Memorizza 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 fa riferimento 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.
- Resi
- Il valore del campo o
nilse il campo non è stato impostato.
- Eccezioni
-
NSInvalidArgumentException se la chiave fa riferimento a un campo predefinito che non è un campo stringa.
| - (void) setInteger: | (NSInteger) | value | |
| forKey: | (NSString *) | key | |
Memorizza un valore in un campo intero.
- 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 intero.
| - (NSInteger) integerForKey: | (NSString *) | key |
Legge il valore di un campo intero.
- Parameters
-
key The key for the field.
- Resi
- 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 intero.
| - (NSInteger) integerForKey: | (NSString *) | key | |
| defaultValue: | (NSInteger) | defaultValue | |
Legge il valore di un campo intero.
- Parameters
-
key The key for the field. defaultValue The value to return if the field has not been set.
- Resi
- Il valore del campo o il valore predefinito specificato se il campo non è stato impostato.
- Eccezioni
-
NSInvalidArgumentException se la chiave si riferisce a un campo predefinito che non è un campo intero.
| - (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 fa riferimento a un campo predefinito che non è un campo double.
| - (double) doubleForKey: | (NSString *) | key |
Legge il valore di un campo double.
- Parameters
-
key The key for the field.
- Resi
- Il valore del campo o 0 se il campo non è stato impostato.
- Eccezioni
-
NSInvalidArgumentException se la chiave fa riferimento a un campo predefinito che non è un campo double.
| - (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.
- Resi
- Il valore del campo o il valore predefinito specificato se il campo non è stato impostato.
- Eccezioni
-
NSInvalidArgumentException se la chiave fa riferimento a un campo predefinito che non è un campo double.
| - (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.
| - (NSDate *__nullable) dateForKey: | (NSString *) | key |
Legge il valore di un campo data dalla rappresentazione ISO-8601 con limitazioni della data.
- Parameters
-
key The field name.
- Resi
- La data o
nilse questo campo non è stato impostato.
- Eccezioni
-
NSInvalidArgumentException 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.
- Resi
- La data come stringa contenente la rappresentazione ISO-8601 con limitazioni della data o
nilse questo campo non è stato impostato.
- Eccezioni
-
NSInvalidArgumentException se la chiave si riferisce a un campo predefinito che non è un campo data.
Documentazione sui dati dei membri
| - (NSString* const) kGCKMetadataKeyCreationDate |
Chiave stringa: data di creazione.
Il valore è la data e/o l'ora in cui è stato creato il media, nel formato ISO-8601. Ad esempio, la data e l'ora in cui è stata scattata una fotografia o registrato un brano musicale.
| - (NSString* const) kGCKMetadataKeyReleaseDate |
Chiave della stringa: data di uscita.
Il valore è la data e/o l'ora in cui è stato rilasciato il contenuto multimediale, in formato ISO-8601. Ad esempio, la data di uscita di un film o di un album musicale.
| - (NSString* const) kGCKMetadataKeyBroadcastDate |
Chiave stringa: data di 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 della prima trasmissione di una puntata di un programma TV.
| - (NSString* const) kGCKMetadataKeyTitle |
Chiave della stringa: Titolo.
Il titolo del contenuto multimediale. Ad esempio, potrebbe essere il titolo di una canzone, di un film o di una puntata di un programma TV. Questo valore è adatto per la visualizzazione.
| - (NSString* const) kGCKMetadataKeySubtitle |
Chiave stringa: Subtitle.
Il sottotitolo del contenuto multimediale. Questo valore è adatto per la visualizzazione.
| - (NSString* const) kGCKMetadataKeyArtist |
Chiave della stringa: Artista.
Il nome dell'artista che ha creato il contenuto multimediale. Ad esempio, potrebbe essere il nome di un musicista, di un artista o di un fotografo. Questo valore è adatto per la visualizzazione.
| - (NSString* const) kGCKMetadataKeyAlbumArtist |
Chiave stringa: Album artist.
Il nome dell'artista che ha prodotto un album. Ad esempio, negli album compilation come i DJ mix, l'artista dell'album non è necessariamente lo stesso degli artisti dei singoli brani 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 intera: numero del disco.
Il numero del disco (a partire da 1) a cui appartiene una traccia musicale in un album composto da più dischi.
| - (NSString* const) kGCKMetadataKeyTrackNumber |
Chiave intera: numero della traccia.
Il numero di traccia di una traccia musicale su un disco dell'album. In genere, i numeri delle tracce vengono conteggiati a partire da 1, ma questo valore può essere 0 se si tratta di una "traccia nascosta" all'inizio di un album.
| - (NSString* const) kGCKMetadataKeySeasonNumber |
Chiave intera: numero della stagione.
Il numero della stagione a cui appartiene la puntata di un programma TV. In genere, i numeri delle stagioni vengono conteggiati a partire da 1, ma questo valore può essere 0 se si tratta di un episodio "pilota" precedente all'inizio ufficiale di una serie TV.
| - (NSString* const) kGCKMetadataKeyEpisodeNumber |
Chiave intera: numero della puntata.
Il numero di un episodio in una determinata stagione di un programma TV. In genere i numeri delle puntate vengono conteggiati a partire da 1, ma questo valore può essere 0 se si tratta di una puntata "pilota" che non è considerata una puntata ufficiale della prima stagione.
| - (NSString* const) kGCKMetadataKeySeriesTitle |
Chiave stringa: titolo della serie.
Il nome di una serie. Ad esempio, potrebbe essere il 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 contenuto multimediale. 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 intera: Larghezza.
La larghezza di un elemento multimediale, in pixel. In genere, questo tipo di dati viene utilizzato per fornire le dimensioni di una fotografia.
| - (NSString* const) kGCKMetadataKeyHeight |
Chiave intera: altezza.
L'altezza di un elemento multimediale, in pixel. In genere, questo tipo di dati viene utilizzato per fornire le dimensioni di una fotografia.
| - (NSString* const) kGCKMetadataKeyLocationName |
Chiave stringa: nome della località.
Il nome di una località in cui è stato creato un contenuto multimediale. Ad esempio, potrebbe trattarsi della posizione di una fotografia o del luogo di riprese principale di un film. Questo valore è adatto per la visualizzazione.
| - (NSString* const) kGCKMetadataKeyLocationLatitude |
Chiave doppia: latitudine della località.
Il componente di latitudine della posizione geografica in cui è stato creato un contenuto multimediale. Ad esempio, potrebbe trattarsi della posizione di una fotografia o del luogo di riprese principale di un film.
| - (NSString* const) kGCKMetadataKeyLocationLongitude |
Chiave doppia: longitudine della località.
Il componente di longitudine della posizione geografica in cui è stato creato un contenuto multimediale. Ad esempio, potrebbe trattarsi della posizione di una fotografia o del luogo di riprese principale di un film.
Dettaglio proprietà
|
readnonatomicassign |
Il tipo di metadati.