GCKMediaMetadata-Klasse

Referenz zur GCKMediaMetadata-Klasse

Übersicht

Ein Container für Medienmetadaten.

Metadaten haben einen Medientyp, eine optionale Liste von Bildern und eine Sammlung von Metadatenfeldern. Schlüssel für allgemeine Metadatenfelder sind als Konstanten vordefiniert, aber die Anwendung kann eigene Felder definieren und verwenden.

Die Werte der vordefinierten Felder haben vordefinierte Typen. Beispielsweise ist eine Titelnummer ein NSInteger und ein Erstellungsdatum ein NSString, der eine ISO-8601-Darstellung von Datum und Uhrzeit enthält. Wenn Sie versuchen, einen Wert eines falschen Typs in einem Feld zu speichern, wird ein Fehler vom Typ NS InvalidA);"> ausgegeben.

Beachten Sie, dass das Cast-Protokoll begrenzt, welche Metadatenfelder für einen bestimmten Medientyp verwendet werden können. Wenn ein MediaMetadata-Objekt für die Übertragung an einen Cast-Empfänger in JSON serialisiert wird, werden vordefinierte Felder, die für einen bestimmten Medientyp nicht unterstützt werden, nicht in die serialisierte Form aufgenommen. Alle anwendungsdefinierten Felder sind jedoch immer enthalten. Die vollständige Liste vordefinierter Felder sieht so aus:

Feld Werttyp Gültige Metadatentypen
kGCKMetadataKeyCreationDate NSDate GCKMediaMetadataTypePhoto
kGCKMetadataKeyReleaseDate NSDate GCKMediaMetadataTypeGeneric, GCKMediaMetadataTypeMovie, GCKMediaMetadataTypeTVShow, GCKMediaMetadataTypeMusicTrack
kGCKMetadataKeyBroadcastDate NSDate GCKMediaMetadataTypeTVShow
kGCKMetadataKeyTitle NSString GCKMediaMetadataTypeGeneric, GCKMediaMetadataTypeMovie, GCKMediaMetadataTypeTVShow, GCKMediaMetadataTypeMusicTrack, GCKMediaMetadataTypePhoto
kGCKMetadataKeySubtitle NSString GCKMediaMetadataTypeGeneric, GCKMediaMetadataTypeMovie
kGCKMetadataKeyArtist NSString GCKMediaMetadataTypeGeneric, GCKMediaMetadataTypeMusicTrack, 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 doppelt GCKMediaMetadataTypePhoto
kGCKMetadataKeyLocationLongitude doppelt GCKMediaMetadataTypePhoto

Übernimmt NSObject. Implementiert <NSCopy>.

Zusammenfassung der Instanzmethoden

(instancetype) - initWithMetadataType:
 Initialisiert ein neues, leeres MediaMetadata-Objekt mit dem angegebenen Medientyp. Mehr...
 
(instancetype) - init
 Initialisieren Sie mit dem generischen Metadatentyp. Mehr...
 
(GCKMediaMetadataType- metadataType
 Der Metadatentyp. Mehr...
 
(NSArray *) - images
 Ruft die Liste der Bilder ab. Mehr...
 
(void) - removeAllMediaImages
 Entfernt alle aktuellen Bilder. Mehr...
 
(void) - addImage:
 Fügt der Liste der Bilder ein Bild hinzu. Mehr...
 
(BOOL) - containsKey:
 Prüft, ob das Objekt ein Feld mit dem angegebenen Schlüssel enthält. Mehr...
 
(NSArray< NSString * > *) - allKeys
 Gibt eine Reihe von Schlüsseln für alle Felder zurück, die im Objekt vorhanden sind. Mehr...
 
(id __nullable) - objectForKey:
 Liest den Wert eines Felds. Mehr...
 
(void) - setString:forKey:
 Speichert einen Wert in einem Stringfeld. Mehr...
 
(NSString *__nullable) - stringForKey:
 Liest den Wert eines Stringfelds. Mehr...
 
(void) - setInteger:forKey:
 Speichert einen Wert in einem Ganzzahlfeld. Mehr...
 
(NSInteger) - integerForKey:
 Liest den Wert eines Ganzzahlfelds. Mehr...
 
(NSInteger) - integerForKey:defaultValue:
 Liest den Wert eines Ganzzahlfelds. Mehr...
 
(void) - setDouble:forKey:
 Speichert einen Wert in einem double-Feld. Mehr...
 
(double) - doubleForKey:
 Liest den Wert eines double-Felds. Mehr...
 
(double) - doubleForKey:defaultValue:
 Liest den Wert eines double-Felds. Mehr...
 
(void) - setDate:forKey:
 Speichert einen Wert in einem Datumsfeld als eingeschränkte ISO-8601-Darstellung des Datums. Mehr...
 
(NSDate *__nullable) - dateForKey:
 Liest den Wert eines Datumsfelds aus der eingeschränkten ISO-8601-Darstellung des Datums. Mehr...
 
(NSString *__nullable) - dateAsStringForKey:
 Liest den Wert eines Datumsfelds als String. Mehr...
 

Öffentliche Attribute

NSString *const kGCKMetadataKeyCreationDate
 Stringschlüssel: Erstellungsdatum. Mehr...
 
NSString *const kGCKMetadataKeyReleaseDate
 Stringschlüssel: Veröffentlichungsdatum. Mehr...
 
NSString *const kGCKMetadataKeyBroadcastDate
 Stringschlüssel: Datum der Übertragung. Mehr...
 
NSString *const kGCKMetadataKeyTitle
 Stringschlüssel: Titel. Mehr...
 
NSString *const kGCKMetadataKeySubtitle
 Stringschlüssel: Untertitel. Mehr...
 
NSString *const kGCKMetadataKeyArtist
 Stringschlüssel: Künstler. Mehr...
 
NSString *const kGCKMetadataKeyAlbumArtist
 Stringschlüssel: Interpret des Albums. Mehr...
 
NSString *const kGCKMetadataKeyAlbumTitle
 Stringschlüssel: Albumtitel. Mehr...
 
NSString *const kGCKMetadataKeyComposer
 Stringschlüssel: Composer. Mehr...
 
NSString *const kGCKMetadataKeyDiscNumber
 Ganzzahlschlüssel: CD-Nummer. Mehr...
 
NSString *const kGCKMetadataKeyTrackNumber
 Ganzzahlschlüssel: Verfolgungsnummer. Mehr...
 
NSString *const kGCKMetadataKeySeasonNumber
 Ganzzahlschlüssel: Staffelnummer. Mehr...
 
NSString *const kGCKMetadataKeyEpisodeNumber
 Ganzzahlschlüssel: Nummer der Folge. Mehr...
 
NSString *const kGCKMetadataKeySeriesTitle
 Stringschlüssel: Buchreihentitel. Mehr...
 
NSString *const kGCKMetadataKeyStudio
 Stringschlüssel: Studio. Mehr...
 
NSString *const kGCKMetadataKeyWidth
 Ganzzahlschlüssel: Breite. Mehr...
 
NSString *const kGCKMetadataKeyHeight
 Ganzzahlschlüssel: Höhe. Mehr...
 
NSString *const kGCKMetadataKeyLocationName
 Stringschlüssel: Standortname. Mehr...
 
NSString *const kGCKMetadataKeyLocationLatitude
 Doppeltaste: Breitengrad des Standorts Mehr...
 
NSString *const kGCKMetadataKeyLocationLongitude
 Doppeltaste: Längengrad des Ortes Mehr...
 

Property-Zusammenfassung

GCKMediaMetadataType metadataType
 Der Metadatentyp. Mehr...
 

Methodendetail

- (instancetype) initWithMetadataType: (GCKMediaMetadataType metadataType

Initialisiert ein neues, leeres MediaMetadata-Objekt mit dem angegebenen Medientyp.

Angegebener Initialisierer.

Parameters
metadataTypeThe media type; one of the GCKMediaMetadataType constants, or a value greater than or equal to GCKMediaMetadataTypeUser for custom media types.
- (instancetype) init

Initialisieren Sie mit dem generischen Metadatentyp.

- (GCKMediaMetadataType) metadataType

Der Metadatentyp.

- (NSArray *) images

Ruft die Liste der Bilder ab.

- (void) removeAllMediaImages

Entfernt alle aktuellen Bilder.

- (void) addImage: (GCKImage *)  image

Fügt der Liste der Bilder ein Bild hinzu.

Parameters
imageThe image to add.
- (BOOL) containsKey: (NSString *)  key

Prüft, ob das Objekt ein Feld mit dem angegebenen Schlüssel enthält.

Parameters
keyThe key.
Gibt Folgendes zurück:
YES, wenn das Feld vorhanden ist, andernfalls NO.
- (NSArray<NSString *> *) allKeys

Gibt eine Reihe von Schlüsseln für alle Felder zurück, die im Objekt vorhanden sind.

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

Liest den Wert eines Felds.

Parameters
keyThe key for the field.
Gibt Folgendes zurück:
Der Wert des Felds oder nil, wenn das Feld nicht festgelegt wurde.
- (void) setString: (NSString *)  value
forKey: (NSString *)  key 

Speichert einen Wert in einem Stringfeld.

Parameters
valueThe new value for the field.
keyThe key for the field.
Ausnahmen
NS InvalidA);">Der Schlüssel verweist auf ein vordefiniertes Feld, das kein Stringfeld ist.
- (NSString *__nullable) stringForKey: (NSString *)  key

Liest den Wert eines Stringfelds.

Parameters
keyThe key for the field.
Gibt Folgendes zurück:
Der Wert des Felds oder nil, wenn das Feld nicht festgelegt wurde.
Ausnahmen
NS InvalidA);">Der Schlüssel verweist auf ein vordefiniertes Feld, das kein Stringfeld ist.
- (void) setInteger: (NSInteger)  value
forKey: (NSString *)  key 

Speichert einen Wert in einem Ganzzahlfeld.

Parameters
valueThe new value for the field.
keyThe key for the field.
Ausnahmen
NS InvalidA);">Der Schlüssel verweist auf ein vordefiniertes Feld, das kein Ganzzahlfeld ist.
- (NSInteger) integerForKey: (NSString *)  key

Liest den Wert eines Ganzzahlfelds.

Parameters
keyThe key for the field.
Gibt Folgendes zurück:
Der Wert des Felds oder 0, wenn das Feld nicht festgelegt wurde.
Ausnahmen
NS InvalidA);">Der Schlüssel verweist auf ein vordefiniertes Feld, das kein Ganzzahlfeld ist.
- (NSInteger) integerForKey: (NSString *)  key
defaultValue: (NSInteger)  defaultValue 

Liest den Wert eines Ganzzahlfelds.

Parameters
keyThe key for the field.
defaultValueThe value to return if the field has not been set.
Gibt Folgendes zurück:
Der Wert des Felds oder der angegebene Standardwert, wenn das Feld nicht festgelegt wurde.
Ausnahmen
NS InvalidA);">Der Schlüssel verweist auf ein vordefiniertes Feld, das kein Ganzzahlfeld ist.
- (void) setDouble: (double)  value
forKey: (NSString *)  key 

Speichert einen Wert in einem double-Feld.

Parameters
valueThe new value for the field.
keyThe key for the field.
Ausnahmen
NS InvalidA);">Der Schlüssel verweist auf ein vordefiniertes Feld, das kein doppeltes Feld ist.
- (double) doubleForKey: (NSString *)  key

Liest den Wert eines double-Felds.

Parameters
keyThe key for the field.
Gibt Folgendes zurück:
Der Wert des Felds oder 0, wenn das Feld nicht festgelegt wurde.
Ausnahmen
NS InvalidA);">Der Schlüssel verweist auf ein vordefiniertes Feld, das kein doppeltes Feld ist.
- (double) doubleForKey: (NSString *)  key
defaultValue: (double)  defaultValue 

Liest den Wert eines double-Felds.

Parameters
defaultValueThe value to return if the field has not been set.
keyThe key for the field.
Gibt Folgendes zurück:
Der Wert des Felds oder der angegebene Standardwert, wenn das Feld nicht festgelegt wurde.
Ausnahmen
NS InvalidA);">Der Schlüssel verweist auf ein vordefiniertes Feld, das kein doppeltes Feld ist.
- (void) setDate: (NSDate *)  date
forKey: (NSString *)  key 

Speichert einen Wert in einem Datumsfeld als eingeschränkte ISO-8601-Darstellung des Datums.

Parameters
dateThe new value for the field.
keyThe key for the field.
Ausnahmen
NS InvalidA);">Der Schlüssel verweist auf ein vordefiniertes Feld, das kein Datumsfeld ist.
- (NSDate *__nullable) dateForKey: (NSString *)  key

Liest den Wert eines Datumsfelds aus der eingeschränkten ISO-8601-Darstellung des Datums.

Parameters
keyThe field name.
Gibt Folgendes zurück:
Das Datum oder nil, wenn dieses Feld nicht festgelegt wurde.
Ausnahmen
NS InvalidA);">Der Schlüssel verweist auf ein vordefiniertes Feld, das kein Datumsfeld ist.
- (NSString *__nullable) dateAsStringForKey: (NSString *)  key

Liest den Wert eines Datumsfelds als String.

Parameters
keyThe field name.
Gibt Folgendes zurück:
Das Datum als String mit der eingeschränkten ISO-8601-Darstellung des Datums oder nil, wenn dieses Feld nicht festgelegt wurde.
Ausnahmen
NS InvalidA);">Der Schlüssel verweist auf ein vordefiniertes Feld, das kein Datumsfeld ist.

Dokumentation zu Mitgliedsdaten

- (NSString* const) kGCKMetadataKeyCreationDate

Stringschlüssel: Erstellungsdatum.

Der Wert ist das Datum und/oder die Uhrzeit, zu der die Medien erstellt wurden. Die Angabe erfolgt im ISO-8601-Format. Dabei kann es sich beispielsweise um das Datum und die Uhrzeit handeln, an dem ein Foto oder ein Musikstück aufgenommen wurde.

- (NSString* const) kGCKMetadataKeyReleaseDate

Stringschlüssel: Veröffentlichungsdatum.

Der Wert ist das Datum und/oder die Uhrzeit der Veröffentlichung der Medien im ISO-8601-Format. Das kann z. B. das Datum sein, an dem ein Film oder Musikalbum veröffentlicht wurde.

- (NSString* const) kGCKMetadataKeyBroadcastDate

Stringschlüssel: Datum der Übertragung.

Der Wert gibt das Datum und/oder die Zeit an, zu der die Medien erstmals übertragen wurden. Die Angabe erfolgt im ISO-8601-Format. Das könnte z. B. das Datum sein, an dem eine Folge einer Serie zum ersten Mal ausgestrahlt wurde.

- (NSString* const) kGCKMetadataKeyTitle

Stringschlüssel: Titel.

Der Titel des Mediums. Das kann z. B. der Titel eines Songs, eines Films oder einer Folge einer Serie sein. Dieser Wert ist für Anzeigezwecke geeignet.

- (NSString* const) kGCKMetadataKeySubtitle

Stringschlüssel: Untertitel.

Der Untertitel der Medien. Dieser Wert ist für Anzeigezwecke geeignet.

- (NSString* const) kGCKMetadataKeyArtist

Stringschlüssel: Künstler.

Der Name des Künstlers, der die Medien erstellt hat. Das könnte beispielsweise der Name eines Musikers, Künstlers oder Fotografen sein. Dieser Wert ist für Anzeigezwecke geeignet.

- (NSString* const) kGCKMetadataKeyAlbumArtist

Stringschlüssel: Interpret des Albums.

Der Name des Künstlers, der ein Album produziert hat. In Kompilationen wie DJ-Mixen ist der Interpret eines Albums beispielsweise nicht unbedingt der Interpret der einzelnen Titel des Albums. Dieser Wert ist für Anzeigezwecke geeignet.

- (NSString* const) kGCKMetadataKeyAlbumTitle

Stringschlüssel: Albumtitel.

Der Titel des Albums, zu dem der Musiktitel gehört. Dieser Wert ist für Anzeigezwecke geeignet.

- (NSString* const) kGCKMetadataKeyComposer

Stringschlüssel: Composer.

Der Name des Komponisten eines Musiktitels. Dieser Wert ist für Anzeigezwecke geeignet.

- (NSString* const) kGCKMetadataKeyDiscNumber

Ganzzahlschlüssel: CD-Nummer.

Die Nummer der CD (zählen 1), zu der der Musiktitel in einem Album mit mehreren Discs gehört.

- (NSString* const) kGCKMetadataKeyTrackNumber

Ganzzahlschlüssel: Verfolgungsnummer.

Die Nummer eines Musiktitels auf einer Albumdisk. Normalerweise werden Titelnummern ab 1 gezählt. Dieser Wert kann aber auch 0 sein, wenn es sich um einen „verborgenen Titel“ am Anfang eines Albums handelt.

- (NSString* const) kGCKMetadataKeySeasonNumber

Ganzzahlschlüssel: Staffelnummer.

Die Nummer der Staffel, zu der eine Folge einer Serie gehört. In der Regel werden Staffelzahlen ab 1 gezählt. Dieser Wert kann jedoch 0 sein, wenn es sich um eine Pilotfolge handelt, die vor dem offiziellen Start einer Serie liegt.

- (NSString* const) kGCKMetadataKeyEpisodeNumber

Ganzzahlschlüssel: Nummer der Folge.

Die Anzahl einer Folge in einer bestimmten Staffel einer Serie. In der Regel werden die Folgen ab 1 gezählt. Dieser Wert kann jedoch 0 sein, wenn es sich um eine Pilotfolge handelt, die nicht als offizielle Folge der ersten Staffel gilt.

- (NSString* const) kGCKMetadataKeySeriesTitle

Stringschlüssel: Buchreihentitel.

Der Name einer Reihe. Das kann beispielsweise der Name einer Serie oder einer Reihe ähnlicher Musikalben sein. Dieser Wert ist für Anzeigezwecke geeignet.

- (NSString* const) kGCKMetadataKeyStudio

Stringschlüssel: Studio.

Der Name eines Tonstudios, das ein Medium produziert hat. Das kann beispielsweise der Name eines Filmstudios oder eines Musiklabels sein. Dieser Wert ist für Anzeigezwecke geeignet.

- (NSString* const) kGCKMetadataKeyWidth

Ganzzahlschlüssel: Breite.

Die Breite eines Medienelements in Pixeln Er wird in der Regel verwendet, um die Abmessungen eines Fotos anzugeben.

- (NSString* const) kGCKMetadataKeyHeight

Ganzzahlschlüssel: Höhe.

Die Höhe eines Medienelements in Pixeln Er wird in der Regel verwendet, um die Abmessungen eines Fotos anzugeben.

- (NSString* const) kGCKMetadataKeyLocationName

Stringschlüssel: Standortname.

Der Name eines Speicherorts, an dem ein Medienelement erstellt wurde. Dabei kann es sich beispielsweise um den Ort eines Fotos oder den Hauptdrehort eines Films handeln. Dieser Wert ist für Anzeigezwecke geeignet.

- (NSString* const) kGCKMetadataKeyLocationLatitude

Doppeltaste: Breitengrad des Standorts

Die Breitengrad-Komponente des geografischen Standorts, an dem ein Medienobjekt erstellt wurde Dabei kann es sich beispielsweise um den Ort eines Fotos oder den Hauptdrehort eines Films handeln.

- (NSString* const) kGCKMetadataKeyLocationLongitude

Doppeltaste: Längengrad des Ortes

Der Längengrad des geografischen Standorts, an dem ein Medienobjekt erstellt wurde Dabei kann es sich beispielsweise um den Ort eines Fotos oder den Hauptdrehort eines Films handeln.

Property-Details

- (GCKMediaMetadataType) metadataType
readnonatomicassign

Der Metadatentyp.