Übersicht

Ein Container für Media-Metadaten.

Metadaten haben einen Medientyp, eine optionale Liste von Bildern und eine Sammlung von Metadatenfeldern. Schlüssel für gängige Metadatenfelder sind als Konstanten vordefiniert. Die Anwendung kann jedoch zusätzliche eigene Felder definieren und verwenden.

Die Werte der vordefinierten Felder haben vordefinierte Typen. Eine Titelnummer ist beispielsweise ein NSInteger und ein Erstellungsdatum ein NSString mit einer ISO 8601-Darstellung eines Datums und einer Uhrzeit. Wenn Sie versuchen, einen Wert eines falschen Typs in einem Feld zu speichern, wird eine NSInvalidArgumentException ausgelöst.

Das Cast-Protokoll schränkt ein, welche Metadatenfelder für einen bestimmten Medientyp verwendet werden können. Wenn ein MediaMetadata-Objekt zur Übermittlung an einen Cast-Empfänger in JSON serialisiert wird, werden alle vordefinierten Felder, die für einen bestimmten Medientyp nicht unterstützt werden, nicht in die serialisierte Form aufgenommen. Alle anwendungsdefinierten Felder werden jedoch immer berücksichtigt. Die vollständige Liste der vordefinierten 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	double	GCKMediaMetadataTypePhoto
kGCKMetadataKeyLocationLongitude	double	GCKMediaMetadataTypePhoto

Erbt von NSObject. Implementiert <NSCopying>.

Zusammenfassung der Instanzmethoden
(instancetype)	- initWithMetadataType:
	Initialisiert neue, leere MediaMetadata mit dem angegebenen Medientyp. Weitere Informationen

(instancetype)	- init
	Initialisieren Sie mit dem generischen Metadatentyp. Weitere Informationen

(GCKMediaMetadataType)	- metadataType
	Der Metadatentyp. Weitere Informationen

(NSArray *)	- images
	Ruft die Liste der Bilder ab. Weitere Informationen

(void)	- removeAllMediaImages
	Entfernt alle aktuellen Bilder. Weitere Informationen

(void)	- addImage:
	Fügt der Liste der Bilder ein Bild hinzu. Weitere Informationen

(BOOL)	- containsKey:
	Prüft, ob das Objekt ein Feld mit dem angegebenen Schlüssel enthält. Weitere Informationen

(NSArray< NSString * > *)	- allKeys
	Gibt eine Reihe von Schlüsseln für alle Felder zurück, die im Objekt vorhanden sind. Weitere Informationen

(id __nullable)	- objectForKey:
	Liest den Wert eines Felds. Weitere Informationen

(void)	- setString:forKey:
	Speichert einen Wert in einem Stringfeld. Weitere Informationen

(NSString *__nullable)	- stringForKey:
	Liest den Wert eines Stringfelds. Weitere Informationen

(void)	- setInteger:forKey:
	Speichert einen Wert in einem Ganzzahlfeld. Weitere Informationen

(NSInteger)	- integerForKey:
	Liest den Wert eines Ganzzahlfelds. Weitere Informationen

(NSInteger)	- integerForKey:defaultValue:
	Liest den Wert eines Ganzzahlfelds. Weitere Informationen

(void)	- setDouble:forKey:
	Speichert einen Wert in einem double-Feld. Weitere Informationen

(double)	- doubleForKey:
	Liest den Wert eines double-Felds. Weitere Informationen

(double)	- doubleForKey:defaultValue:
	Liest den Wert eines double-Felds. Weitere Informationen

(void)	- setDate:forKey:
	Speichert einen Wert in einem Datumsfeld als eingeschränkte ISO-8601-Darstellung des Datums. Weitere Informationen

(NSDate *__nullable)	- dateForKey:
	Liest den Wert eines Datumsfelds aus der eingeschränkten ISO-8601-Darstellung des Datums. Weitere Informationen

(NSString *__nullable)	- dateAsStringForKey:
	Liest den Wert eines Datumsfelds als String. Weitere Informationen

Öffentliche Attribute
NSString *const	kGCKMetadataKeyCreationDate
	String-Schlüssel: Erstellungsdatum. Weitere Informationen

NSString *const	kGCKMetadataKeyReleaseDate
	String-Schlüssel: Veröffentlichungsdatum. Weitere Informationen

NSString *const	kGCKMetadataKeyBroadcastDate
	Stringschlüssel: Datum der Ausstrahlung. Weitere Informationen

NSString *const	kGCKMetadataKeyTitle
	String-Schlüssel: „Title“. Weitere Informationen

NSString *const	kGCKMetadataKeySubtitle
	String-Schlüssel: Subtitle. Weitere Informationen

NSString *const	kGCKMetadataKeyArtist
	String-Schlüssel: Artist. Weitere Informationen

NSString *const	kGCKMetadataKeyAlbumArtist
	String-Schlüssel: Albumkünstler. Weitere Informationen

NSString *const	kGCKMetadataKeyAlbumTitle
	String-Schlüssel: Albumtitel. Weitere Informationen

NSString *const	kGCKMetadataKeyComposer
	String-Schlüssel: Composer. Weitere Informationen

NSString *const	kGCKMetadataKeyDiscNumber
	Ganzzahlschlüssel: CD-Nummer. Weitere Informationen

NSString *const	kGCKMetadataKeyTrackNumber
	Ganzzahliger Schlüssel: Titelnummer. Weitere Informationen

NSString *const	kGCKMetadataKeySeasonNumber
	Ganzzahliger Schlüssel: Nummer der Staffel. Weitere Informationen

NSString *const	kGCKMetadataKeyEpisodeNumber
	Ganzzahlschlüssel: Nummer der Folge. Weitere Informationen

NSString *const	kGCKMetadataKeySeriesTitle
	String-Schlüssel: Titel der Reihe. Weitere Informationen

NSString *const	kGCKMetadataKeyStudio
	String-Schlüssel: Studio. Weitere Informationen

NSString *const	kGCKMetadataKeyWidth
	Ganzzahlschlüssel: Breite. Weitere Informationen

NSString *const	kGCKMetadataKeyHeight
	Ganzzahlschlüssel: Höhe. Weitere Informationen

NSString *const	kGCKMetadataKeyLocationName
	String-Schlüssel: Standortname. Weitere Informationen

NSString *const	kGCKMetadataKeyLocationLatitude
	Doppelschlüssel: Breitengrad des Standorts. Weitere Informationen

NSString *const	kGCKMetadataKeyLocationLongitude
	Doppelschlüssel: Längengrad des Standorts. Weitere Informationen

Zusammenfassung der Property
GCKMediaMetadataType	metadataType
	Der Metadatentyp. Weitere Informationen

Methodendetail

- (instancetype) initWithMetadataType: (GCKMediaMetadataType) metadataType

Initialisiert neue, leere MediaMetadata mit dem angegebenen Medientyp.

Designated Initializer

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

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

image The image to add.

- (BOOL) containsKey: (NSString *) key

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

Parameters

key The key.

Ausgabe: 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

key	The key for the field.

Ausgabe: 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

value	The new value for the field.
key	The key for the field.

Ausnahmen

NSInvalidArgumentException wenn sich der Schlüssel auf ein vordefiniertes Feld bezieht, das kein String-Feld ist.

- (NSString *__nullable) stringForKey: (NSString *) key

Liest den Wert eines Stringfelds.

Parameters

key	The key for the field.

Ausgabe: Der Wert des Felds oder nil, wenn das Feld nicht festgelegt wurde.

Ausnahmen

NSInvalidArgumentException wenn sich der Schlüssel auf ein vordefiniertes Feld bezieht, das kein String-Feld ist.

- (void) setInteger:	(NSInteger)	value
forKey:	(NSString *)	key

Speichert einen Wert in einem Ganzzahlfeld.

Parameters

value	The new value for the field.
key	The key for the field.

Ausnahmen

NSInvalidArgumentException wenn sich der Schlüssel auf ein vordefiniertes Feld bezieht, das kein Ganzzahlfeld ist.

- (NSInteger) integerForKey: (NSString *) key

Liest den Wert eines Ganzzahlfelds.

Parameters

key	The key for the field.

Ausgabe: Der Wert des Felds oder 0, wenn das Feld nicht festgelegt wurde.

Ausnahmen

NSInvalidArgumentException wenn sich der Schlüssel auf ein vordefiniertes Feld bezieht, das kein Ganzzahlfeld ist.

- (NSInteger) integerForKey:	(NSString *)	key
defaultValue:	(NSInteger)	defaultValue

Liest den Wert eines Ganzzahlfelds.

Parameters

key	The key for the field.
defaultValue	The value to return if the field has not been set.

Ausgabe: Der Wert des Felds oder der angegebene Standardwert, wenn das Feld nicht festgelegt wurde.

Ausnahmen

NSInvalidArgumentException wenn sich der Schlüssel auf ein vordefiniertes Feld bezieht, das kein Ganzzahlfeld ist.

- (void) setDouble:	(double)	value
forKey:	(NSString *)	key

Speichert einen Wert in einem double-Feld.

Parameters

value	The new value for the field.
key	The key for the field.

Ausnahmen

NSInvalidArgumentException wenn sich der Schlüssel auf ein vordefiniertes Feld bezieht, das kein double-Feld ist.

- (double) doubleForKey: (NSString *) key

Liest den Wert eines double-Felds.

Parameters

key	The key for the field.

Ausgabe: Der Wert des Felds oder 0, wenn das Feld nicht festgelegt wurde.

Ausnahmen

NSInvalidArgumentException wenn sich der Schlüssel auf ein vordefiniertes Feld bezieht, das kein double-Feld ist.

- (double) doubleForKey:	(NSString *)	key
defaultValue:	(double)	defaultValue

Liest den Wert eines double-Felds.

Parameters

defaultValue	The value to return if the field has not been set.
key	The key for the field.

Ausgabe: Der Wert des Felds oder der angegebene Standardwert, wenn das Feld nicht festgelegt wurde.

Ausnahmen

NSInvalidArgumentException wenn sich der Schlüssel auf ein vordefiniertes Feld bezieht, das kein double-Feld ist.

- (void) setDate:	(NSDate *)	date
forKey:	(NSString *)	key

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

Parameters

date	The new value for the field.
key	The key for the field.

Ausnahmen

NSInvalidArgumentException wenn der Schlüssel auf ein vordefiniertes Feld verweist, das kein Datumsfeld ist.

- (NSDate *__nullable) dateForKey: (NSString *) key

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

Parameters

key	The field name.

Ausgabe: Das Datum oder nil, wenn dieses Feld nicht festgelegt wurde.

Ausnahmen

NSInvalidArgumentException wenn der Schlüssel auf ein vordefiniertes Feld verweist, das kein Datumsfeld ist.

- (NSString *__nullable) dateAsStringForKey: (NSString *) key

Liest den Wert eines Datumsfelds als String.

Parameters

key	The field name.

Ausgabe: Das Datum als String mit der eingeschränkten ISO 8601-Darstellung des Datums oder nil, wenn dieses Feld nicht festgelegt wurde.

Ausnahmen

NSInvalidArgumentException wenn der Schlüssel auf ein vordefiniertes Feld verweist, das kein Datumsfeld ist.

Dokumentation zu Mitgliedsdaten

- (NSString* const) kGCKMetadataKeyCreationDate

String-Schlüssel: Erstellungsdatum.

Der Wert ist das Datum und/oder die Uhrzeit, zu der die Media erstellt wurden, im ISO 8601-Format. Das kann zum Beispiel das Datum und die Uhrzeit sein, zu der ein Foto aufgenommen oder ein Musikstück aufgenommen wurde.

- (NSString* const) kGCKMetadataKeyReleaseDate

String-Schlüssel: Veröffentlichungsdatum.

Der Wert ist das Datum und/oder die Uhrzeit, zu der die Media veröffentlicht wurden, im ISO 8601-Format. Das kann beispielsweise das Datum sein, an dem ein Film oder ein Musikalbum veröffentlicht wurde.

- (NSString* const) kGCKMetadataKeyBroadcastDate

Stringschlüssel: Datum der Ausstrahlung.

Der Wert ist das Datum und/oder die Uhrzeit, zu der die Media zum ersten Mal gesendet wurden, im ISO 8601-Format. Das kann beispielsweise das Datum sein, an dem eine Folge einer TV-Serie zum ersten Mal ausgestrahlt wurde.

- (NSString* const) kGCKMetadataKeyTitle

String-Schlüssel: „Title“.

Der Titel des Mediums. Das kann beispielsweise der Titel eines Songs, Films oder einer Serienfolge sein. Dieser Wert eignet sich für die Anzeige.

- (NSString* const) kGCKMetadataKeySubtitle

String-Schlüssel: Subtitle.

Der Untertitel des Mediums. Dieser Wert eignet sich für die Anzeige.

- (NSString* const) kGCKMetadataKeyArtist

String-Schlüssel: Artist.

Der Name des Künstlers, der die Medien erstellt hat. Das kann beispielsweise der Name eines Musikers, Künstlers oder Fotografen sein. Dieser Wert eignet sich für die Anzeige.

- (NSString* const) kGCKMetadataKeyAlbumArtist

String-Schlüssel: Albumkünstler.

Der Name des Künstlers, der ein Album produziert hat. Bei Kompilationsalben wie DJ-Mixen ist der Albumkünstler beispielsweise nicht unbedingt derselbe wie der Künstler der einzelnen Songs auf dem Album. Dieser Wert eignet sich für die Anzeige.

- (NSString* const) kGCKMetadataKeyAlbumTitle

String-Schlüssel: Albumtitel.

Der Titel des Albums, zu dem ein Musiktitel gehört. Dieser Wert eignet sich für die Anzeige.

- (NSString* const) kGCKMetadataKeyComposer

String-Schlüssel: Composer.

Der Name des Komponisten eines Musiktitels. Dieser Wert eignet sich für die Anzeige.

- (NSString* const) kGCKMetadataKeyDiscNumber

Ganzzahlschlüssel: CD-Nummer.

Die Nummer der Disc (ab 1), zu der ein Musiktitel in einem Album mit mehreren Discs gehört.

- (NSString* const) kGCKMetadataKeyTrackNumber

Ganzzahliger Schlüssel: Titelnummer.

Die Titelnummer eines Musiktitels auf einer Album-CD. Normalerweise werden Titelnummern ab 1 gezählt. Dieser Wert kann jedoch auch 0 sein, wenn es sich um einen „Hidden Track“ am Anfang eines Albums handelt.

- (NSString* const) kGCKMetadataKeySeasonNumber

Ganzzahliger Schlüssel: Nummer der Staffel.

Die Staffelnummer, zu der eine Folge einer TV-Serie gehört. Normalerweise werden Staffeln ab 1 gezählt. Dieser Wert kann jedoch 0 sein, wenn es sich um eine Pilotfolge handelt, die vor dem offiziellen Start einer Serie veröffentlicht wurde.

- (NSString* const) kGCKMetadataKeyEpisodeNumber

Ganzzahlschlüssel: Nummer der Folge.

Die Nummer einer Folge in einer bestimmten Staffel einer TV-Serie. Folgennummern werden in der Regel 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

String-Schlüssel: Titel der Reihe.

Der Name einer Serie. Das kann beispielsweise der Name einer TV-Show oder einer Reihe von zusammengehörigen Musik-Alben sein. Dieser Wert eignet sich für die Anzeige.

- (NSString* const) kGCKMetadataKeyStudio

String-Schlüssel: Studio.

Der Name eines Aufnahmestudios, in dem ein Media-Inhalt produziert wurde. Das kann beispielsweise der Name eines Filmstudios oder Musiklabels sein. Dieser Wert eignet sich für die Anzeige.

- (NSString* const) kGCKMetadataKeyWidth

Ganzzahlschlüssel: Breite.

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

- (NSString* const) kGCKMetadataKeyHeight

Ganzzahlschlüssel: Höhe.

Die Höhe eines Media-Elements in Pixeln. Dies wird in der Regel verwendet, um die Abmessungen eines Fotos anzugeben.

- (NSString* const) kGCKMetadataKeyLocationName

String-Schlüssel: Standortname.

Der Name eines Orts, an dem ein Medium erstellt wurde. Das kann beispielsweise der Ort sein, an dem ein Foto aufgenommen wurde, oder der Hauptdrehort eines Films. Dieser Wert eignet sich für die Anzeige.

- (NSString* const) kGCKMetadataKeyLocationLatitude

Doppelschlüssel: Breitengrad des Standorts.

Der Breitengrad des geografischen Standorts, an dem ein Medium erstellt wurde. Das kann beispielsweise der Ort sein, an dem ein Foto aufgenommen wurde, oder der Hauptdrehort eines Films.

- (NSString* const) kGCKMetadataKeyLocationLongitude

Doppelschlüssel: Längengrad des Standorts.

Die Längengradkomponente des geografischen Standorts, an dem ein Medium erstellt wurde. Das kann beispielsweise der Ort sein, an dem ein Foto aufgenommen wurde, oder der Hauptdrehort eines Films.

Property-Details

- (GCKMediaMetadataType) metadataType

readnonatomicassign

Der Metadatentyp.

GCKMediaMetadata-Klasse Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Übersicht

Zusammenfassung der Instanzmethoden

Öffentliche Attribute

Zusammenfassung der Property

Methodendetail

Dokumentation zu Mitgliedsdaten

Property-Details

GCKMediaMetadata-Klasse