Ü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:
Ü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, andernfallsNO.
| - (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
|
readnonatomicassign |
Der Metadatentyp.