Überblick

Ein Container für Medienmetadaten.

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

Die Werte der vordefinierten Felder haben vordefinierte Typen. Eine Titelnummer ist beispielsweise ein NSInteger und ein Erstellungsdatum ist ein NSString mit einer ISO 8601-Darstellung von Datum und Uhrzeit. Bei dem Versuch, einen Wert eines falschen Typs in einem Feld zu speichern, wird eine NSInvalidArgumentException ausgegeben.

Beachten Sie, dass durch das Cast-Protokoll eingeschränkt wird, 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 das serialisierte Formular aufgenommen. anwendungsdefinierte 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	Double	GCKMediaMetadataTypePhoto
kGCKMetadataKeyLocationLongitude	Double	GCKMediaMetadataTypePhoto

Übernimmt NSObject, <NSKopieren> und <NSSecureCoding>.

Übersicht über Instanzmethoden
(instancetype)	- initWithMetadataType:
	Initialisiert ein neues, leeres MediaMetadata-Objekt mit dem angegebenen Medientyp. Mehr...

(instancetype)	- init
	Initialisieren Sie die Datei mit dem generischen Metadatentyp. Mehr...

(GCKMediaMetadataType)	- metadataType
	Der Metadatentyp. Mehr...

(NSArray *)	- images
	Ruft die Liste der Images ab. Mehr...

(void)	- removeAllMediaImages
	Entfernt alle aktuellen Bilder. Mehr...

(void)	- addImage:
	Fügt der Image-Liste ein Image hinzu. Mehr...

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

(NSArray< NSString * > *)	- allKeys
	Gibt einen Satz Schlüssel für alle Felder zurück, die im Objekt vorhanden sind. Mehr...

(nullable id)	- objectForKey:
	Liest den Wert eines Felds. Mehr...

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

(nullable NSString *)	- 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 Felds vom Typ double. Mehr...

(double)	- doubleForKey:defaultValue:
	Liest den Wert eines Felds vom Typ double. Mehr...

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

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

(nullable NSString *)	- 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: Übertragungsdatum. 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: Titelnummer. Mehr...

NSString *const	kGCKMetadataKeySeasonNumber
	Ganzzahlschlüssel: Staffelnummer. Mehr...

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

NSString *const	kGCKMetadataKeySeriesTitle
	Stringschlüssel: Titel der Reihe. 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: Name des Standorts. Mehr...

NSString *const	kGCKMetadataKeyLocationLatitude
	Doppelte Taste: Breitengrad des Ortes. Mehr...

NSString *const	kGCKMetadataKeyLocationLongitude
	Doppeltaste: Längengrad des Ortes. Mehr...

NSString *const	kGCKMetadataKeyBookTitle
	Stringschlüssel: Buchtitel. Mehr...

NSString *const	kGCKMetadataKeyChapterNumber
	Ganzzahlschlüssel: Kapitelnummer. Mehr...

NSString *const	kGCKMetadataKeyChapterTitle
	Stringschlüssel: Kapiteltitel. Mehr...

NSString *const	kGCKMetadataKeySectionDuration
	Doppeltaste: Dauer des Abschnitts. Mehr...

NSString *const	kGCKMetadataKeySectionStartTimeInMedia
	Doppeltaste: Startzeit des Abschnitts in den Medien. Mehr...

NSString *const	kGCKMetadataKeySectionStartAbsoluteTime
	Doppelte Taste: Absolute Startzeit des Abschnitts. Mehr...

NSString *const	kGCKMetadataKeySectionStartTimeInContainer
	Doppelschlüssel: Startzeit des Abschnitts im Container. Mehr...

NSString *const	kGCKMetadataKeyQueueItemID
	Doppelschlüssel: ID des Warteschlangenelements. Mehr...

Property-Zusammenfassung
GCKMediaMetadataType	metadataType
	Der Metadatentyp. Mehr...

Methodendetail

- (instancetype) initWithMetadataType: (GCKMediaMetadataType) metadataType

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

Definierter Initialisierer.

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 die Datei mit dem generischen Metadatentyp.

- (GCKMediaMetadataType) metadataType

Der Metadatentyp.

- (NSArray *) images

Ruft die Liste der Images ab.

- (void) removeAllMediaImages

Entfernt alle aktuellen Bilder.

- (void) addImage: (GCKImage *) image

Fügt der Image-Liste ein Image 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.

Rückgaben: YES, wenn das Feld vorhanden ist, andernfalls NO.

- (NSArray<NSString *> *) allKeys

Gibt einen Satz Schlüssel für alle Felder zurück, die im Objekt vorhanden sind.

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

Liest den Wert eines Felds.

Parameters

key	The key for the field.

Rückgaben: 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 der Schlüssel verweist auf ein vordefiniertes Feld, das kein Stringfeld ist.

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

Liest den Wert eines Stringfelds.

Parameters

key	The key for the field.

Rückgaben: Der Wert des Felds oder nil, wenn das Feld nicht festgelegt wurde.

Ausnahmen

NSInvalidArgumentException 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

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

Ausnahmen

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

- (NSInteger) integerForKey: (NSString *) key

Liest den Wert eines Ganzzahlfelds.

Parameters

key	The key for the field.

Rückgaben: Der Wert des Felds oder 0, wenn das Feld noch nicht festgelegt wurde.

Ausnahmen

NSInvalidArgumentException 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

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

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

Ausnahmen

NSInvalidArgumentException 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

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

Ausnahmen

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

- (double) doubleForKey: (NSString *) key

Liest den Wert eines Felds vom Typ double.

Parameters

key	The key for the field.

Rückgaben: Der Wert des Felds oder 0, wenn das Feld noch nicht festgelegt wurde.

Ausnahmen

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

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

Liest den Wert eines Felds vom Typ double.

Parameters

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

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

Ausnahmen

NSInvalidArgumentException der Schlüssel verweist auf ein vordefiniertes Feld, 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 der Schlüssel auf ein vordefiniertes Feld verweist, das kein Datumsfeld ist.

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

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

Parameters

key	The field name.

Rückgaben: Das Datum oder nil, wenn dieses Feld nicht festgelegt wurde.

Ausnahmen

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

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

Liest den Wert eines Datumsfelds als String.

Parameters

key	The field name.

Rückgaben: Das Datum als String, der die eingeschränkte ISO 8601-Darstellung des Datums enthält, oder nil, wenn dieses Feld nicht festgelegt wurde.

Ausnahmen

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

Dokumentation zu Mitgliederdaten

- (NSString* const) kGCKMetadataKeyCreationDate

Stringschlüssel: Erstellungsdatum.

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

- (NSString* const) kGCKMetadataKeyReleaseDate

Stringschlüssel: Veröffentlichungsdatum.

Der Wert im ISO-8601-Format ist das Datum und/oder die Uhrzeit der Veröffentlichung des Mediums. Dabei kann es sich beispielsweise um das Veröffentlichungsdatum eines Films oder Musikalbums handeln.

- (NSString* const) kGCKMetadataKeyBroadcastDate

Stringschlüssel: Übertragungsdatum.

Der Wert im ISO-8601-Format ist das Datum und/oder die Uhrzeit, zu der das Medium zum ersten Mal ausgestrahlt wurde. Dabei kann es sich z. B. um das Datum handeln, an dem die Folge einer TV-Sendung erstmals ausgestrahlt wurde.

- (NSString* const) kGCKMetadataKeyTitle

Stringschlüssel: Titel.

Der Titel des Mediums. Das kann beispielsweise der Titel eines Songs, Films oder der Folge einer Serie sein. Dieser Wert eignet sich zur Anzeige.

- (NSString* const) kGCKMetadataKeySubtitle

Stringschlüssel: Untertitel.

Der Untertitel des Mediums. Dieser Wert eignet sich zur Anzeige.

- (NSString* const) kGCKMetadataKeyArtist

Stringschlüssel: Künstler.

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

- (NSString* const) kGCKMetadataKeyAlbumArtist

Stringschlüssel: Interpret des Albums.

Der Name des Künstlers, der ein Album produziert hat. Bei Compilation-Alben wie DJ-Mixen muss der Interpret des Albums nicht unbedingt mit den Interpret(en) der einzelnen Songs des Albums identisch sein. Dieser Wert eignet sich zur Anzeige.

- (NSString* const) kGCKMetadataKeyAlbumTitle

Stringschlüssel: Albumtitel.

Der Titel des Albums, zu dem ein Musiktitel gehört Dieser Wert eignet sich zur Anzeige.

- (NSString* const) kGCKMetadataKeyComposer

Stringschlüssel: Composer.

Der Name des Komponisten eines Musiktitels. Dieser Wert eignet sich zur Anzeige.

- (NSString* const) kGCKMetadataKeyDiscNumber

Ganzzahlschlüssel: CD-Nummer.

Die CD-Nummer (ab 1), zu der ein Musiktitel auf einem Album mit mehreren CDs gehört.

- (NSString* const) kGCKMetadataKeyTrackNumber

Ganzzahlschlü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 "verborgenen Titel" am Anfang eines Albums handelt.

- (NSString* const) kGCKMetadataKeySeasonNumber

Ganzzahlschlüssel: Staffelnummer.

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

- (NSString* const) kGCKMetadataKeyEpisodeNumber

Ganzzahlschlüssel: Nummer der Folge.

Die Nummer einer Folge in einer bestimmten Staffel einer Serie. In der Regel wird die Nummer der Folge 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: Titel der Reihe.

Der Name einer Reihe. Das kann z. B. der Name einer TV-Sendung oder einer Serie ähnlicher Musikalben sein. Dieser Wert eignet sich zur Anzeige.

- (NSString* const) kGCKMetadataKeyStudio

Stringschlüssel: Studio.

Der Name eines Aufnahmestudios, das einen Medieninhalt produziert hat. Dies könnte beispielsweise der Name eines Filmstudios oder Musiklabels sein. Dieser Wert eignet sich zur Anzeige.

- (NSString* const) kGCKMetadataKeyWidth

Ganzzahlschlüssel: Breite.

Die Breite eines Medienelements in Pixeln. Dieser wird normalerweise verwendet, um die Abmessungen eines Fotos anzugeben.

- (NSString* const) kGCKMetadataKeyHeight

Ganzzahlschlüssel: Höhe.

Die Höhe eines Medienelements in Pixeln. Dieser wird normalerweise verwendet, um die Abmessungen eines Fotos anzugeben.

- (NSString* const) kGCKMetadataKeyLocationName

Stringschlüssel: Name des Standorts.

Der Name eines Ortes, an dem ein Medienelement erstellt wurde. Dies kann beispielsweise der Drehort eines Fotos oder der Hauptdrehort eines Films sein. Dieser Wert eignet sich zur Anzeige.

- (NSString* const) kGCKMetadataKeyLocationLatitude

Doppelte Taste: Breitengrad des Ortes.

Die Breitengrad-Komponente des geografischen Standorts, an dem ein Medienelement erstellt wurde. Dies kann beispielsweise der Drehort eines Fotos oder der Hauptdrehort eines Films sein.

- (NSString* const) kGCKMetadataKeyLocationLongitude

Doppeltaste: Längengrad des Ortes.

Die Längengradkomponente des geografischen Standorts, an dem ein Medienelement erstellt wurde. Dies kann beispielsweise der Drehort eines Fotos oder der Hauptdrehort eines Films sein.

- (NSString* const) kGCKMetadataKeyBookTitle

Stringschlüssel: Buchtitel.

Der Titel eines Hörbuchs.

Seit: 4.3.5

- (NSString* const) kGCKMetadataKeyChapterNumber

Ganzzahlschlüssel: Kapitelnummer.

Die Nummer eines Kapitels in einem Hörbuch.

Seit: 4.3.5

- (NSString* const) kGCKMetadataKeyChapterTitle

Stringschlüssel: Kapiteltitel.

Der Titel eines Kapitels in einem Hörbuch.

Seit: 4.3.5

- (NSString* const) kGCKMetadataKeySectionDuration

Doppeltaste: Dauer des Abschnitts.

Die Dauer des Abschnitts in Sekunden. Wird für Warteschlangenmetadaten verwendet. Das kann beispielsweise die Dauer einer TV-Sendung in einer Wiedergabeliste, die Kapiteldauer eines Hörbuchs oder die Dauer eines langen Livestreams sein.

Seit: 4.4.1

- (NSString* const) kGCKMetadataKeySectionStartTimeInMedia

Doppeltaste: Startzeit des Abschnitts in den Medien.

Der Versatz der Abschnittsstartzeit vom Beginn des Medienelements in Sekunden. Wird für Warteschlangenmetadaten verwendet.

Seit: 4.4.1

- (NSString* const) kGCKMetadataKeySectionStartAbsoluteTime

Doppelte Taste: Absolute Startzeit des Abschnitts.

Die absolute Zeit des Abschnittsbeginns, in Epochenzeit in Sekunden. Wird für Warteschlangenmetadaten verwendet.

Seit: 4.4.1

- (NSString* const) kGCKMetadataKeySectionStartTimeInContainer

Doppelschlüssel: Startzeit des Abschnitts im Container.

Der Versatz der Abschnittsstartzeit im vollen Container. Wird für Warteschlangenmetadaten verwendet.

Seit: 4.4.1

- (NSString* const) kGCKMetadataKeyQueueItemID

Doppelschlüssel: ID des Warteschlangenelements.

Die ID des Warteschlangenelements, das die Startzeit des Abschnitts enthält. Wird für Warteschlangenmetadaten verwendet.

Seit: 4.4.1

Objektdetails

- (GCKMediaMetadataType) metadataType

readnonatomicassign

Der Metadatentyp.

GCKMediaMetadata-Klasse

Überblick

Übersicht über Instanzmethoden

Öffentliche Attribute

Property-Zusammenfassung

Methodendetail

Dokumentation zu Mitgliederdaten

Objektdetails