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

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, 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

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

- (GCKMediaMetadataType) metadataType

readnonatomicassign

Typ metadanych.

Klasa GCKMediaMetadata

Opis

Podsumowanie metody instancji

Atrybuty publiczne

Podsumowanie usługi

Szczegóły metody

Dokumentacja danych członków

Szczegóły nieruchomości