Omówienie

Kontener na metadane multimediów.

Metadane zawierają typ multimediów, opcjonalną listę obrazów i zbiór pól metadanych. Klucze dla popularnych pól metadanych są wstępnie zdefiniowane jako stałe, ale aplikacja może definiować dodatkowe pola i używać ich we własnych polach.

Wartości wstępnie zdefiniowanych pól mają wstępnie zdefiniowane typy. Numer śledzenia to na przykład NSInteger, a data utworzenia to NSString zawierający datę i godzinę w standardzie ISO-8601. Próba zapisania wartości nieprawidłowego typu w polu spowoduje zgłoszenie błędu NSNieprawidłowyArgumentException.

Pamiętaj, że protokół przesyłania określa, których pól metadanych można użyć w przypadku danego typu mediów. Gdy obiekt MediaMetadata jest zserializowany do formatu JSON na potrzeby dostarczenia do odbiornika Cast, żadne wstępnie zdefiniowane pola, które nie są obsługiwane przez dany typ multimediów, nie będą uwzględniane w serii formularza, ale zawsze będą uwzględniane pola zdefiniowane przez aplikację. Pełna lista wstępnie zdefiniowanych pól wygląda tak:

Pole	Typ wartości	Prawidłowe typy metadanych
kGCKMetadataKeyCreationDate	NSDate (w języku angielskim)	GCKMediaMetadataTypePhoto
kGCKMetadataKeyReleaseDate	NSDate (w języku angielskim)	GCKMediaMetadataTypeGeneric, GCKMediaMetadataTypeMovie, GCKMediaMetadataTypeTVShow, GCKMediaMetadataTypeMusicTrack
kGCKMetadataKeyBroadcastDate	NSDate (w języku angielskim)	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	podwójny	GCKMediaMetadataTypePhoto
kGCKMetadataKeyLocationLongitude	podwójny	GCKMediaMetadataTypePhoto

Dziedziczy NSObject. Stosuje <NSCopy>>.

Podsumowanie metody instancji
(instancetype)	- initWithMetadataType:
	Inicjuje nowy, pusty element MediaMetadata o podanym typie mediów. Więcej...

(instancetype)	- init
	Zainicjuj ją od 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. Więcej...

(BOOL)	- containsKey:
	Sprawdza, czy obiekt zawiera pole o podanym kluczu. Więcej...

(NSArray< NSString * > *)	- allKeys
	Zwraca zestaw kluczy dla wszystkich pól obecnych w obiekcie. Więcej...

(id __nullable)	- objectForKey:
	Odczytuje wartość pola. Więcej...

(void)	- setString:forKey:
	Zapisuje wartość w polu ciągu. Więcej...

(NSString *__nullable)	- stringForKey:
	Odczytuje wartość pola ciągu znaków. Więcej...

(void)	- setInteger:forKey:
	Zapisuje wartość w polu liczby całkowitej. Więcej...

(NSInteger)	- integerForKey:
	Odczytuje wartość pola liczby całkowitej. Więcej...

(NSInteger)	- integerForKey:defaultValue:
	Odczytuje wartość pola liczby całkowitej. Więcej...

(void)	- setDouble:forKey:
	Zapisuje wartość w polu podwójny. Więcej...

(double)	- doubleForKey:
	Odczytuje wartość pola podwójny. Więcej...

(double)	- doubleForKey:defaultValue:
	Odczytuje wartość pola podwójny. Więcej...

(void)	- setDate:forKey:
	Zapisuje wartość w polu daty jako ograniczoną reprezentację daty w formacie ISO-8601. Więcej...

(NSDate *__nullable)	- dateForKey:
	Odczytuje wartość pola daty z zastrzeżonego formatu daty ISO-8601. Więcej...

(NSString *__nullable)	- dateAsStringForKey:
	Odczytuje wartość 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 premiery. Więcej...

NSString *const	kGCKMetadataKeyBroadcastDate
	Klucz ciągu: data transmisji. Więcej...

NSString *const	kGCKMetadataKeyTitle
	Klucz ciągu: tytuł. Więcej...

NSString *const	kGCKMetadataKeySubtitle
	Klucz ciągu: podtytuł. Więcej...

NSString *const	kGCKMetadataKeyArtist
	Klucz ciągu: wykonawca. Więcej...

NSString *const	kGCKMetadataKeyAlbumArtist
	Klucz ciągu: 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
	Klucz ciągu: 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...

Podsumowanie usługi
GCKMediaMetadataType	metadataType
	Typ metadanych. Więcej...

Szczegóły metody

- (instancetype) initWithMetadataType: (GCKMediaMetadataType) metadataType

Inicjuje nowy, pusty element MediaMetadata o podanym typie mediów.

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 ją od 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.

Parameters

image The image to add.

- (BOOL) containsKey: (NSString *) key

Sprawdza, czy obiekt zawiera pole o podanym kluczu.

Parameters

key The key.

Zwraca: YES, jeśli pole istnieje, NO.

- (NSArray<NSString *> *) allKeys

Zwraca zestaw kluczy dla wszystkich pól obecnych w obiekcie.

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

Odczytuje wartość pola.

Parameters

key	The key for the field.

Zwraca: Wartość pola lub nil, jeśli pole nie zostało ustawione.

- (void) setString:	(NSString *)	value
forKey:	(NSString *)	key

Zapisuje wartość w polu ciągu.

Parameters

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

Wyjątki

Wyjątek NSinvalidArgument jeśli klucz odnosi się do wstępnie zdefiniowanego pola, które nie jest polem tekstowym.

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

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

Parameters

key	The key for the field.

Zwraca: Wartość pola lub nil, jeśli pole nie zostało ustawione.

Wyjątki

Wyjątek NSinvalidArgument jeśli klucz odnosi się do wstępnie zdefiniowanego pola, które nie jest polem tekstowym.

- (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.

Wyjątki

Wyjątek NSinvalidArgument jeśli klucz odnosi się do wstępnie zdefiniowanego pola, które nie jest liczbą całkowitą.

- (NSInteger) integerForKey: (NSString *) key

Odczytuje wartość pola liczby całkowitej.

Parameters

key	The key for the field.

Zwraca: Wartość pola, czyli 0, jeśli to pole nie zostało ustawione.

Wyjątki

Wyjątek NSinvalidArgument jeśli klucz odnosi się do wstępnie zdefiniowanego pola, które nie jest liczbą całkowitą.

- (NSInteger) integerForKey:	(NSString *)	key
defaultValue:	(NSInteger)	defaultValue

Odczytuje wartość pola liczby całkowitej.

Parameters

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

Zwraca: Wartość pola lub podana wartość domyślna, jeśli pole nie zostało ustawione.

Wyjątki

Wyjątek NSinvalidArgument jeśli klucz odnosi się do wstępnie zdefiniowanego pola, które nie jest liczbą całkowitą.

- (void) setDouble:	(double)	value
forKey:	(NSString *)	key

Zapisuje wartość w polu podwójny.

Parameters

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

Wyjątki

Wyjątek NSinvalidArgument jeśli klucz odnosi się do wstępnie zdefiniowanego pola, które nie jest podwójną wartością.

- (double) doubleForKey: (NSString *) key

Odczytuje wartość pola podwójny.

Parameters

key	The key for the field.

Zwraca: Wartość pola, czyli 0, jeśli to pole nie zostało ustawione.

Wyjątki

Wyjątek NSinvalidArgument jeśli klucz odnosi się do wstępnie zdefiniowanego pola, które nie jest podwójną wartością.

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

Odczytuje wartość pola podwójny.

Parameters

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

Zwraca: Wartość pola lub podana wartość domyślna, jeśli pole nie zostało ustawione.

Wyjątki

Wyjątek NSinvalidArgument jeśli klucz odnosi się do wstępnie zdefiniowanego pola, które nie jest podwójną wartością.

- (void) setDate:	(NSDate *)	date
forKey:	(NSString *)	key

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

Parameters

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

Wyjątki

Wyjątek NSinvalidArgument jeśli klucz odnosi się do wstępnie zdefiniowanego pola, które nie jest polem daty.

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

Odczytuje wartość pola daty z zastrzeżonego formatu daty ISO-8601.

Parameters

key	The field name.

Zwraca: Data lub nil, jeśli to pole nie zostało ustawione.

Wyjątki

Wyjątek NSinvalidArgument jeśli klucz odnosi się do wstępnie zdefiniowanego pola, które nie jest polem daty.

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

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

Parameters

key	The field name.

Zwraca: Data w postaci ciągu zawierającego ograniczenie daty w formacie ISO-8601 lub nil, jeśli to pole nie zostało ustawione.

Wyjątki

Wyjątek NSinvalidArgument 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 pliku multimedialnego, w formacie ISO 8601. Może to być na przykład data i godzina zrobienia zdjęcia lub nagrania muzyki.

- (NSString* const) kGCKMetadataKeyReleaseDate

Klucz ciągu: data premiery.

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.

- (NSString* const) kGCKMetadataKeyBroadcastDate

Klucz ciągu: data transmisji.

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

- (NSString* const) kGCKMetadataKeyTitle

Klucz ciągu: tytuł.

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

- (NSString* const) kGCKMetadataKeySubtitle

Klucz ciągu: podtytuł.

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

- (NSString* const) kGCKMetadataKeyArtist

Klucz ciągu: wykonawca.

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

- (NSString* const) kGCKMetadataKeyAlbumArtist

Klucz ciągu: wykonawca albumu.

Nazwa wykonawcy, który wyprodukował album. Na przykład w kompilacjach takich jak składanki DJ-ów, wykonawca albumu może się różnić od wykonawcy poszczególnych utworów na albumie. Ta wartość jest odpowiednia do wyświetlania.

- (NSString* const) kGCKMetadataKeyAlbumTitle

Klucz ciągu: tytuł albumu.

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

- (NSString* const) kGCKMetadataKeyComposer

Klucz ciągu: Composer.

Nazwa 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órego należy utwór w albumie wielodyskowym.

- (NSString* const) kGCKMetadataKeyTrackNumber

Klucz liczby całkowitej: numer utworu.

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

- (NSString* const) kGCKMetadataKeySeasonNumber

Klucz liczby całkowitej: numer sezonu.

Numer sezonu, do którego należy odcinek programu. Zwykle numery odcinków są liczone od 1 wartości, ale ta wartość może wynosić 0, jeśli jest to odcinek „pilotażowy” sprzed oficjalnego odcinka 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, ale ta wartość może wynosić 0, jeśli jest to odcinek „pilotażowy”, który nie został uznany za oficjalny odcinek pierwszego sezonu.

- (NSString* const) kGCKMetadataKeySeriesTitle

Klucz ciągu: tytuł serii.

Nazwa serii. Może to być na przykład tytuł programu telewizyjnego lub serii 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 jakiś materiał. 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). Tego atrybutu zwykle używa się do określania wymiarów zdjęcia.

- (NSString* const) kGCKMetadataKeyHeight

Klucz liczby całkowitej: Wysokość.

Wysokość elementu multimedialnego (w pikselach). Tego atrybutu zwykle używa się do określania wymiarów zdjęcia.

- (NSString* const) kGCKMetadataKeyLocationName

Klucz ciągu: nazwa lokalizacji.

Nazwa lokalizacji, w której utworzono nośnik. Może to być na przykład lokalizacja zdjęcia lub główne miejsce filmowania. 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 utwór. Może to być na przykład lokalizacja zdjęcia lub główne miejsce filmowania.

- (NSString* const) kGCKMetadataKeyLocationLongitude

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

Komponent długości geograficznej lokalizacji geograficznej, w której utworzono dany materiał. Może to być na przykład lokalizacja zdjęcia lub główne miejsce filmowania.

Szczegóły usługi

- (GCKMediaMetadataType) metadataType

readnonatomicassign

Typ metadanych.

Klasa GCKMediaMetadata

Omówienie

Podsumowanie metody instancji

Atrybuty publiczne

Podsumowanie usługi

Szczegóły metody

Dokumentacja danych członków

Szczegóły usługi