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:
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
-
metadataType The 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
-
image The image to add.
| - (BOOL) containsKey: | (NSString *) | key |
Sprawdza, czy obiekt zawiera pole o podanym kluczu.
- Parameters
-
key The key.
- Akcje powrotne
YES, jeśli pole istnieje, lubNOw 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
-
key The 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
-
value The new value for the field. key The key for the field.
- działania związane z wyjątkami.
-
NSInvalidArgumentException jeś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
-
key The key for the field.
- Akcje powrotne
- Wartość pola lub
nil, jeśli pole nie zostało ustawione.
- działania związane z wyjątkami.
-
NSInvalidArgumentException jeś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
-
value The new value for the field. key The key for the field.
- działania związane z wyjątkami.
-
NSInvalidArgumentException jeś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
-
key The key for the field.
- Akcje powrotne
- Wartość pola lub 0, jeśli pole nie zostało ustawione.
- działania związane z wyjątkami.
-
NSInvalidArgumentException jeś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
-
key The key for the field. defaultValue The 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.
-
NSInvalidArgumentException jeś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
-
value The new value for the field. key The key for the field.
- działania związane z wyjątkami.
-
NSInvalidArgumentException jeś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
-
key The key for the field.
- Akcje powrotne
- Wartość pola lub 0, jeśli pole nie zostało ustawione.
- działania związane z wyjątkami.
-
NSInvalidArgumentException jeś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
-
defaultValue The value to return if the field has not been set. key The 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.
-
NSInvalidArgumentException jeś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
-
date The new value for the field. key The key for the field.
- działania związane z wyjątkami.
-
NSInvalidArgumentException jeś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
-
key The field name.
- Akcje powrotne
- Data lub
nil, jeśli to pole nie zostało ustawione.
- działania związane z wyjątkami.
-
NSInvalidArgumentException jeś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
-
key The 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.
-
NSInvalidArgumentException jeś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
|
readnonatomicassign |
Typ metadanych.