Klasa GCKMediaMetadata

Odniesienie do klasy GCKMediaMetadata

Opis

Kontener metadanych multimediów.

Metadane obejmują typ nośnika, opcjonalną listę obrazów i zbiór pól metadanych. Klucze często używanych pól metadanych są wstępnie zdefiniowane jako stałe, ale aplikacja może dowolnie definiować i korzystać z dodatkowych pól.

Wartości wstępnie zdefiniowanych pól mają wstępnie zdefiniowane typy. Na przykład numer ścieżki to NSInteger, a data utworzenia to ciąg NSString zawierający datę i godzinę w standardzie ISO-8601. Próba zapisania w polu wartości nieprawidłowego typu spowoduje zgłoszenie NSInvalidArgumentException.

Pamiętaj, że protokół przesyłania ogranicza liczbę pól metadanych, które można wykorzystać w przypadku danego typu multimediów. Gdy obiekt MediaMetadata jest zserializowany w formacie JSON w celu dostarczenia do odbiornika Cast, wstępnie zdefiniowane pola, które nie są obsługiwane w przypadku danego typu multimediów, nie zostaną uwzględnione w formularzu zserializowanym, ale wszystkie pola zdefiniowane przez aplikację będą zawsze uwzględniane. Pełna lista wstępnie zdefiniowanych pól:

Pole Typ wartości Prawidłowe typy metadanych
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 liczba zmiennoprzecinkowa GCKMediaMetadataTypePhoto
kGCKMetadataKeyLocationLongitude liczba zmiennoprzecinkowa GCKMediaMetadataTypePhoto

Dziedziczy NSObject, <NSCopying> i <NSSecureCoding>.

Podsumowanie metody instancji

(instancetype) - initWithMetadataType:
 Inicjuje nowy, pusty element MediaMetadata o podanym typie nośnika. Więcej...
 
(instancetype) - init
 Zainicjuj za pomocą ogólnego typu metadanych. Więcej...
 
(GCKMediaMetadataType- metadataType
 Typ metadanych. Więcej...
 
(NSArray *) - images
 Pobiera listę obrazów. Więcej...
 
(void) - removeAllMediaImages
 Usuwa wszystkie bieżące obrazy. Więcej...
 
(void) - addImage:
 Dodaje obraz do listy obrazów. Więcej...
 
(BOOL) - containsKey:
 Sprawdza, czy obiekt zawiera pole o podanym kluczu. Więcej...
 
(NSArray< NSString * > *) - allKeys
 Zwraca zestaw kluczy dla wszystkich pól znajdujących się w obiekcie. Więcej...
 
(nullable id) - objectForKey:
 Odczytuje wartość pola. Więcej...
 
(void) - setString:forKey:
 Zapisuje wartość w polu ciągu znaków. Więcej...
 
(nullable NSString *) - stringForKey:
 Odczytuje wartość z pola ciągu znaków. Więcej...
 
(void) - setInteger:forKey:
 Zapisuje wartość w polu liczby całkowitej. Więcej...
 
(NSInteger) - integerForKey:
 Odczytuje wartość z pola liczby całkowitej. Więcej...
 
(NSInteger) - integerForKey:defaultValue:
 Odczytuje wartość z pola liczby całkowitej. Więcej...
 
(void) - setDouble:forKey:
 Zapisuje wartość w polu podwójnym. Więcej...
 
(double) - doubleForKey:
 Odczytuje wartość pola double. Więcej...
 
(double) - doubleForKey:defaultValue:
 Odczytuje wartość pola double. Więcej...
 
(void) - setDate:forKey:
 Zapisuje wartość w polu daty jako zastrzeżoną reprezentację daty w formacie ISO-8601. Więcej...
 
(nullable NSDate *) - dateForKey:
 Odczytuje wartość pola daty na podstawie zastrzeżonej reprezentacji daty w formacie ISO-8601. Więcej...
 
(nullable NSString *) - dateAsStringForKey:
 Odczytuje wartość z pola daty w postaci ciągu znaków. Więcej...
 

Atrybuty publiczne

NSString *const kGCKMetadataKeyCreationDate
 Klucz ciągu: data utworzenia. Więcej...
 
NSString *const kGCKMetadataKeyReleaseDate
 Klucz ciągu: data wydania. Więcej...
 
NSString *const kGCKMetadataKeyBroadcastDate
 Klucz ciągu: Data emisji. Więcej...
 
NSString *const kGCKMetadataKeyTitle
 Klucz ciągu: tytuł. Więcej...
 
NSString *const kGCKMetadataKeySubtitle
 Klucz ciągu: Subtitle. Więcej...
 
NSString *const kGCKMetadataKeyArtist
 Ciąg znaków: wykonawca. Więcej...
 
NSString *const kGCKMetadataKeyAlbumArtist
 Ciąg znaków: wykonawca albumu. Więcej...
 
NSString *const kGCKMetadataKeyAlbumTitle
 Klucz ciągu: tytuł albumu. Więcej...
 
NSString *const kGCKMetadataKeyComposer
 Klucz ciągu: Composer. Więcej...
 
NSString *const kGCKMetadataKeyDiscNumber
 Klucz liczby całkowitej: numer dysku. Więcej...
 
NSString *const kGCKMetadataKeyTrackNumber
 Klucz liczby całkowitej: numer utworu. Więcej...
 
NSString *const kGCKMetadataKeySeasonNumber
 Klucz liczby całkowitej: numer sezonu. Więcej...
 
NSString *const kGCKMetadataKeyEpisodeNumber
 Klucz liczby całkowitej: numer odcinka. Więcej...
 
NSString *const kGCKMetadataKeySeriesTitle
 Ciąg znaków: tytuł serii. Więcej...
 
NSString *const kGCKMetadataKeyStudio
 Klucz ciągu: Studio. Więcej...
 
NSString *const kGCKMetadataKeyWidth
 Klucz liczby całkowitej: Szerokość. Więcej...
 
NSString *const kGCKMetadataKeyHeight
 Klucz liczby całkowitej: wysokość. Więcej...
 
NSString *const kGCKMetadataKeyLocationName
 Klucz ciągu: nazwa lokalizacji. Więcej...
 
NSString *const kGCKMetadataKeyLocationLatitude
 Podwójny klucz: szerokość geograficzna lokalizacji. Więcej...
 
NSString *const kGCKMetadataKeyLocationLongitude
 Podwójny klucz: długość geograficzna lokalizacji. Więcej...
 
NSString *const kGCKMetadataKeyBookTitle
 Ciąg znaków: tytuł książki. Więcej...
 
NSString *const kGCKMetadataKeyChapterNumber
 Klucz liczby całkowitej: numer rozdziału. Więcej...
 
NSString *const kGCKMetadataKeyChapterTitle
 Klucz ciągu: tytuł rozdziału. Więcej...
 
NSString *const kGCKMetadataKeySectionDuration
 Podwójny klucz: czas trwania sekcji. Więcej...
 
NSString *const kGCKMetadataKeySectionStartTimeInMedia
 Podwójny klawisz: czas rozpoczęcia sekcji w multimediach. Więcej...
 
NSString *const kGCKMetadataKeySectionStartAbsoluteTime
 Podwójny klucz: bezwzględny czas rozpoczęcia sekcji. Więcej...
 
NSString *const kGCKMetadataKeySectionStartTimeInContainer
 Klucz podwójny: czas rozpoczęcia sekcji w kontenerze. Więcej...
 
NSString *const kGCKMetadataKeyQueueItemID
 Podwójny klucz: identyfikator elementu w kolejce. Więcej...
 

Podsumowanie usługi

GCKMediaMetadataType metadataType
 Typ metadanych. Więcej...
 

Szczegóły metody

- (instancetype) initWithMetadataType: (GCKMediaMetadataType metadataType

Inicjuje nowy, pusty element MediaMetadata o podanym typie nośnika.

Wyznaczony inicjator.

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

Zainicjuj za pomocą ogólnego typu metadanych.

- (GCKMediaMetadataType) metadataType

Typ metadanych.

- (NSArray *) images

Pobiera listę obrazów.

- (void) removeAllMediaImages

Usuwa wszystkie bieżące obrazy.

- (void) addImage: (GCKImage *)  image

Dodaje obraz do listy obrazów.

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

Sprawdza, czy obiekt zawiera pole o podanym kluczu.

Parameters
keyThe key.
Akcje powrotne
YES, jeśli pole istnieje, lub NO w innym przypadku.
- (NSArray<NSString *> *) allKeys

Zwraca zestaw kluczy dla wszystkich pól znajdujących się w obiekcie.

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

Odczytuje wartość pola.

Parameters
keyThe key for the field.
Akcje powrotne
Wartość pola lub nil, jeśli pole nie zostało ustawione.
- (void) setString: (NSString *)  value
forKey: (NSString *)  key 

Zapisuje wartość w polu ciągu znaków.

Parameters
valueThe new value for the field.
keyThe key for the field.
działania związane z wyjątkami.
NSInvalidArgumentExceptionjeśli klucz odnosi się do wstępnie zdefiniowanego pola, które nie jest polem ciągu.
- (nullable NSString *) stringForKey: (NSString *)  key

Odczytuje wartość z pola ciągu znaków.

Parameters
keyThe key for the field.
Akcje powrotne
Wartość pola lub nil, jeśli pole nie zostało ustawione.
działania związane z wyjątkami.
NSInvalidArgumentExceptionjeśli klucz odnosi się do wstępnie zdefiniowanego pola, które nie jest polem ciągu.
- (void) setInteger: (NSInteger)  value
forKey: (NSString *)  key 

Zapisuje wartość w polu liczby całkowitej.

Parameters
valueThe new value for the field.
keyThe key for the field.
działania związane z wyjątkami.
NSInvalidArgumentExceptionjeśli klucz odnosi się do wstępnie zdefiniowanego pola, które nie jest polem liczby całkowitej.
- (NSInteger) integerForKey: (NSString *)  key

Odczytuje wartość z pola liczby całkowitej.

Parameters
keyThe key for the field.
Akcje powrotne
Wartość pola lub 0, jeśli pole nie zostało ustawione.
działania związane z wyjątkami.
NSInvalidArgumentExceptionjeśli klucz odnosi się do wstępnie zdefiniowanego pola, które nie jest polem liczby całkowitej.
- (NSInteger) integerForKey: (NSString *)  key
defaultValue: (NSInteger)  defaultValue 

Odczytuje wartość z pola liczby całkowitej.

Parameters
keyThe key for the field.
defaultValueThe value to return if the field has not been set.
Akcje powrotne
Wartość pola lub podana wartość domyślna, jeśli pole nie zostało ustawione.
działania związane z wyjątkami.
NSInvalidArgumentExceptionjeśli klucz odnosi się do wstępnie zdefiniowanego pola, które nie jest polem liczby całkowitej.
- (void) setDouble: (double)  value
forKey: (NSString *)  key 

Zapisuje wartość w polu podwójnym.

Parameters
valueThe new value for the field.
keyThe key for the field.
działania związane z wyjątkami.
NSInvalidArgumentExceptionjeśli klucz odnosi się do wstępnie zdefiniowanego pola, które nie jest polem podwójnym.
- (double) doubleForKey: (NSString *)  key

Odczytuje wartość pola double.

Parameters
keyThe key for the field.
Akcje powrotne
Wartość pola lub 0, jeśli pole nie zostało ustawione.
działania związane z wyjątkami.
NSInvalidArgumentExceptionjeśli klucz odnosi się do wstępnie zdefiniowanego pola, które nie jest polem podwójnym.
- (double) doubleForKey: (NSString *)  key
defaultValue: (double)  defaultValue 

Odczytuje wartość pola double.

Parameters
defaultValueThe value to return if the field has not been set.
keyThe key for the field.
Akcje powrotne
Wartość pola lub podana wartość domyślna, jeśli pole nie zostało ustawione.
działania związane z wyjątkami.
NSInvalidArgumentExceptionjeśli klucz odnosi się do wstępnie zdefiniowanego pola, które nie jest polem podwójnym.
- (void) setDate: (NSDate *)  date
forKey: (NSString *)  key 

Zapisuje wartość w polu daty jako zastrzeżoną reprezentację daty w formacie ISO-8601.

Parameters
dateThe new value for the field.
keyThe key for the field.
działania związane z wyjątkami.
NSInvalidArgumentExceptionjeśli klucz odnosi się do wstępnie zdefiniowanego pola, które nie jest polem daty.
- (nullable NSDate *) dateForKey: (NSString *)  key

Odczytuje wartość pola daty na podstawie zastrzeżonej reprezentacji daty w formacie ISO-8601.

Parameters
keyThe field name.
Akcje powrotne
Data lub nil, jeśli to pole nie zostało ustawione.
działania związane z wyjątkami.
NSInvalidArgumentExceptionjeśli klucz odnosi się do wstępnie zdefiniowanego pola, które nie jest polem daty.
- (nullable NSString *) dateAsStringForKey: (NSString *)  key

Odczytuje wartość z pola daty w postaci ciągu znaków.

Parameters
keyThe field name.
Akcje powrotne
Data jako ciąg znaków zawierający ograniczoną reprezentację daty w formacie ISO-8601 lub nil, jeśli to pole nie zostało ustawione.
działania związane z wyjątkami.
NSInvalidArgumentExceptionjeśli klucz odnosi się do wstępnie zdefiniowanego pola, które nie jest polem daty.

Dokumentacja danych członków

- (NSString* const) kGCKMetadataKeyCreationDate

Klucz ciągu: data utworzenia.

Wartością jest data i/lub godzina utworzenia nośnika w formacie ISO-8601. Może to być na przykład data i godzina zrobienia zdjęcia lub nagrania utworu muzycznego.

- (NSString* const) kGCKMetadataKeyReleaseDate

Klucz ciągu: data wydania.

Wartością jest data i/lub godzina publikacji multimediów w formacie ISO-8601. Może to być na przykład data premiery filmu lub albumu muzycznego.

- (NSString* const) kGCKMetadataKeyBroadcastDate

Klucz ciągu: Data emisji.

Wartością jest data i/lub godzina pierwszej emisji multimediów w formacie ISO-8601. Może to być na przykład data pierwszej emisji odcinka programu telewizyjnego.

- (NSString* const) kGCKMetadataKeyTitle

Klucz ciągu: tytuł.

Tytuł multimediów. Może to być na przykład tytuł piosenki, filmu lub odcinka serialu bądź programu telewizyjnego. Ta wartość jest odpowiednia do wyświetlania.

- (NSString* const) kGCKMetadataKeySubtitle

Klucz ciągu: Subtitle.

Podtytuł multimediów. Ta wartość jest odpowiednia do wyświetlania.

- (NSString* const) kGCKMetadataKeyArtist

Ciąg znaków: wykonawca.

Nazwa wykonawcy, który utworzył multimedia. Może to być na przykład imię i nazwisko muzyka, wykonawcy lub fotografa. Ta wartość jest odpowiednia do wyświetlania.

- (NSString* const) kGCKMetadataKeyAlbumArtist

Ciąg znaków: wykonawca albumu.

Nazwa wykonawcy, który stworzył album. Na przykład w kompilacjach takich jak składanki DJ-ów wykonawca albumu nie musi być tym samym wykonawcą co wykonawca poszczególnych utworów z albumu. Ta wartość jest odpowiednia do wyświetlania.

- (NSString* const) kGCKMetadataKeyAlbumTitle

Klucz ciągu: tytuł albumu.

Tytuł albumu, do którego należy utwór muzyczny. Ta wartość jest odpowiednia do wyświetlania.

- (NSString* const) kGCKMetadataKeyComposer

Klucz ciągu: Composer.

Imię i nazwisko kompozytora utworu muzycznego. Ta wartość jest odpowiednia do wyświetlania.

- (NSString* const) kGCKMetadataKeyDiscNumber

Klucz liczby całkowitej: numer dysku.

Numer płyty (liczący od 1), do której należy utwór z albumu na wielu płytach.

- (NSString* const) kGCKMetadataKeyTrackNumber

Klucz liczby całkowitej: numer utworu.

Numer utworu muzycznego na płycie albumu. Zwykle numery utworów są liczone od 1, jednak ta wartość może wynosić 0, jeśli utwór jest „ukryty” na początku albumu.

- (NSString* const) kGCKMetadataKeySeasonNumber

Klucz liczby całkowitej: numer sezonu.

Numer sezonu, do którego należy odcinek programu telewizyjnego. Zwykle numery sezonów są liczone od 1, ale ta wartość może wynosić 0, jeśli jest to odcinek „pilotowy”, który przypada przed oficjalnym rozpoczęciem serialu.

- (NSString* const) kGCKMetadataKeyEpisodeNumber

Klucz liczby całkowitej: numer odcinka.

Numer odcinka w danym sezonie programu telewizyjnego. Zwykle numery odcinków są liczone od 1 numeru, ale ta wartość może wynosić 0, jeśli jest to odcinek „pilotowy”, który nie jest oficjalnym odcinkiem pierwszego sezonu.

- (NSString* const) kGCKMetadataKeySeriesTitle

Ciąg znaków: tytuł serii.

Nazwa serii. Może to być na przykład tytuł programu telewizyjnego lub serialu z powiązanych albumów muzycznych. Ta wartość jest odpowiednia do wyświetlania.

- (NSString* const) kGCKMetadataKeyStudio

Klucz ciągu: Studio.

Nazwa studia nagraniowego, które wyprodukowało materiał multimedialny. Może to być na przykład nazwa studia filmowego lub wytwórni muzycznej. Ta wartość jest odpowiednia do wyświetlania.

- (NSString* const) kGCKMetadataKeyWidth

Klucz liczby całkowitej: Szerokość.

Szerokość elementu multimedialnego w pikselach. W ten sposób zwykle podaje się wymiary zdjęcia.

- (NSString* const) kGCKMetadataKeyHeight

Klucz liczby całkowitej: wysokość.

Wysokość elementu multimedialnego w pikselach. W ten sposób zwykle podaje się wymiary zdjęcia.

- (NSString* const) kGCKMetadataKeyLocationName

Klucz ciągu: nazwa lokalizacji.

Nazwa miejsca, w którym utworzono materiał multimedialny. Może to być na przykład lokalizacja zdjęcia lub miejsce, w którym nagrywany jest film. Ta wartość jest odpowiednia do wyświetlania.

- (NSString* const) kGCKMetadataKeyLocationLatitude

Podwójny klucz: szerokość geograficzna lokalizacji.

Komponent szerokości geograficznej lokalizacji geograficznej, w której utworzono materiał multimedialny. Może to być na przykład lokalizacja zdjęcia lub miejsce, w którym nagrywany jest film.

- (NSString* const) kGCKMetadataKeyLocationLongitude

Podwójny klucz: długość geograficzna lokalizacji.

Komponent długości geograficznej lokalizacji geograficznej, w której utworzono materiał multimedialny. Może to być na przykład lokalizacja zdjęcia lub miejsce, w którym nagrywany jest film.

- (NSString* const) kGCKMetadataKeyBookTitle

Ciąg znaków: tytuł książki.

Tytuł audiobooka.

Od
4.3.5
- (NSString* const) kGCKMetadataKeyChapterNumber

Klucz liczby całkowitej: numer rozdziału.

Numer rozdziału w audiobooku.

Od
4.3.5
- (NSString* const) kGCKMetadataKeyChapterTitle

Klucz ciągu: tytuł rozdziału.

Tytuł rozdziału w audiobooku.

Od
4.3.5
- (NSString* const) kGCKMetadataKeySectionDuration

Podwójny klucz: czas trwania sekcji.

Czas trwania sekcji w sekundach. Służy do obsługi metadanych kolejki. Może to być na przykład czas trwania jednego programu telewizyjnego w kolejce, rozdziału w audiobooku lub program długiej transmisji na żywo.

Od
4.4.1
- (NSString* const) kGCKMetadataKeySectionStartTimeInMedia

Podwójny klawisz: czas rozpoczęcia sekcji w multimediach.

Przesunięcie (w sekundach) czasu rozpoczęcia sekcji od początku elementu multimedialnego. Służy do obsługi metadanych kolejki.

Od
4.4.1
- (NSString* const) kGCKMetadataKeySectionStartAbsoluteTime

Podwójny klucz: bezwzględny czas rozpoczęcia sekcji.

Bezwzględny czas rozpoczęcia sekcji, podany w czasie epoki w sekundach. Służy do obsługi metadanych kolejki.

Od
4.4.1
- (NSString* const) kGCKMetadataKeySectionStartTimeInContainer

Klucz podwójny: czas rozpoczęcia sekcji w kontenerze.

Przesunięcie względem czasu rozpoczęcia sekcji w pełnym kontenerze. Służy do obsługi metadanych kolejki.

Od
4.4.1
- (NSString* const) kGCKMetadataKeyQueueItemID

Podwójny klucz: identyfikator elementu w kolejce.

Identyfikator elementu kolejki zawierający czas rozpoczęcia sekcji. Służy do obsługi metadanych kolejki.

Od
4.4.1

Szczegóły nieruchomości

- (GCKMediaMetadataType) metadataType
readnonatomicassign

Typ metadanych.