Przegląd

Kontener metadanych multimediów.

Metadane mają typ multimediów, opcjonalną listę obrazów i kolekcję pól metadanych. Klucze do wspólnych pól metadanych są wstępnie zdefiniowane jako stałe, ale aplikacja może definiować i używać własnych dodatkowych pól.

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

Pamiętaj, że protokół Cast ogranicza pola metadanych, które można wykorzystać w przypadku danego typu multimediów. Gdy obiekt MediaMetadata jest serializowany do formatu JSON w celu dostarczenia do odbiornika Cast, wszystkie predefiniowane pola, które nie są obsługiwane w przypadku danego typu multimediów, nie są uwzględniane w serializowanej postaci, ale wszystkie pola zdefiniowane przez aplikację są 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	double	GCKMediaMetadataTypePhoto
kGCKMetadataKeyLocationLongitude	double	GCKMediaMetadataTypePhoto

Dziedziczy z klasy NSObject. Implementuje protokół <NSCopying>.

Podsumowanie metod instancji
(instancetype)	- initWithMetadataType:
	Inicjuje nowe, puste metadane multimediów o podanym typie. 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 zbiór kluczy wszystkich pól, które znajdują się w obiekcie. Więcej…

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

(void)	- setString:forKey:
	Przechowuje wartość w polu tekstowym. Więcej…

(NSString *__nullable)	- stringForKey:
	Odczytuje wartość pola tekstowego. Więcej…

(void)	- setInteger:forKey:
	Przechowuje 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:
	Przechowuje wartość w polu double. Więcej…

(double)	- doubleForKey:
	Odczytuje wartość pola double. Więcej…

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

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

(NSDate *__nullable)	- dateForKey:
	Odczytuje wartość pola daty z ograniczonej reprezentacji daty w formacie ISO 8601. Więcej…

(NSString *__nullable)	- dateAsStringForKey:
	Odczytuje wartość pola daty jako ciąg znaków. Więcej…

Atrybuty publiczne
NSString *const	kGCKMetadataKeyCreationDate
	Klucz ciągu znaków: data utworzenia. Więcej…

NSString *const	kGCKMetadataKeyReleaseDate
	Klucz ciągu tekstowego: data premiery. Więcej…

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

NSString *const	kGCKMetadataKeyTitle
	Klucz ciągu tekstowego: Title. Więcej…

NSString *const	kGCKMetadataKeySubtitle
	Klucz ciągu znaków: Subtitle. Więcej…

NSString *const	kGCKMetadataKeyArtist
	Klucz ciągu znaków: wykonawca. Więcej…

NSString *const	kGCKMetadataKeyAlbumArtist
	Klucz ciągu tekstowego: wykonawca albumu. Więcej…

NSString *const	kGCKMetadataKeyAlbumTitle
	Klucz ciągu znaków: tytuł albumu. Więcej…

NSString *const	kGCKMetadataKeyComposer
	Klucz ciągu znaków: Composer. Więcej…

NSString *const	kGCKMetadataKeyDiscNumber
	Klucz liczby całkowitej: numer płyty. Więcej…

NSString *const	kGCKMetadataKeyTrackNumber
	Klucz liczby całkowitej: numer utworu. Więcej…

NSString *const	kGCKMetadataKeySeasonNumber
	Klucz w formie liczby całkowitej: numer sezonu. Więcej…

NSString *const	kGCKMetadataKeyEpisodeNumber
	Klucz w formie liczby całkowitej: numer odcinka. Więcej…

NSString *const	kGCKMetadataKeySeriesTitle
	Klucz tekstowy: tytuł serii. Więcej…

NSString *const	kGCKMetadataKeyStudio
	Klucz ciągu znaków: 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 tekstowego: nazwa lokalizacji. Więcej…

NSString *const	kGCKMetadataKeyLocationLatitude
	Klucz podwójny: szerokość geograficzna lokalizacji. Więcej…

NSString *const	kGCKMetadataKeyLocationLongitude
	Klucz podwójny: długość geograficzna lokalizacji. Więcej…

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

Szczegóły metody

- (instancetype) initWithMetadataType: (GCKMediaMetadataType) metadataType

Inicjuje nowe, puste metadane multimediów o podanym typie.

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.

Zwroty: YES, jeśli pole istnieje, NO w przeciwnym razie.

- (NSArray<NSString *> *) allKeys

Zwraca zbiór kluczy wszystkich pól, które znajdują się w obiekcie.

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

Odczytuje wartość pola.

Parameters

key	The key for the field.

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

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

Przechowuje wartość w polu tekstowym.

Parameters

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

Wyjątki

NSInvalidArgumentException jeśli klucz odwołuje się do wstępnie zdefiniowanego pola, które nie jest polem tekstowym.

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

Odczytuje wartość pola tekstowego.

Parameters

key	The key for the field.

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

Wyjątki

NSInvalidArgumentException jeśli klucz odwołuje się do wstępnie zdefiniowanego pola, które nie jest polem tekstowym.

- (void) setInteger:	(NSInteger)	value
forKey:	(NSString *)	key

Przechowuje wartość w polu liczby całkowitej.

Parameters

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

Wyjątki

NSInvalidArgumentException jeśli klucz odwołuje się do predefiniowanego pola, które nie jest polem liczbowym.

- (NSInteger) integerForKey: (NSString *) key

Odczytuje wartość pola liczby całkowitej.

Parameters

key	The key for the field.

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

Wyjątki

NSInvalidArgumentException jeśli klucz odwołuje się do predefiniowanego pola, które nie jest polem liczbowym.

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

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

Wyjątki

NSInvalidArgumentException jeśli klucz odwołuje się do predefiniowanego pola, które nie jest polem liczbowym.

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

Przechowuje wartość w polu double.

Parameters

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

Wyjątki

NSInvalidArgumentException jeśli klucz odwołuje się do predefiniowanego pola, które nie jest polem double.

- (double) doubleForKey: (NSString *) key

Odczytuje wartość pola double.

Parameters

key	The key for the field.

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

Wyjątki

NSInvalidArgumentException jeśli klucz odwołuje się do predefiniowanego pola, które nie jest polem double.

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

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

Wyjątki

NSInvalidArgumentException jeśli klucz odwołuje się do predefiniowanego pola, które nie jest polem double.

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

Przechowuje 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

NSInvalidArgumentException 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 ograniczonej reprezentacji daty w formacie ISO 8601.

Parameters

key	The field name.

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

Wyjątki

NSInvalidArgumentException 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 jako ciąg znaków.

Parameters

key	The field name.

Zwroty: Data w postaci ciągu znaków zawierającego ograniczoną reprezentację daty w formacie ISO 8601 lub nil, jeśli to pole nie zostało ustawione.

Wyjątki

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

Dokumentacja danych użytkowników

- (NSString* const) kGCKMetadataKeyCreationDate

Klucz ciągu znaków: data utworzenia.

Wartość to data lub godzina utworzenia multimediów w formacie ISO-8601. Może to być na przykład data i godzina wykonania zdjęcia lub nagrania utworu muzycznego.

- (NSString* const) kGCKMetadataKeyReleaseDate

Klucz ciągu tekstowego: data premiery.

Wartość to data lub godzina wydania multimediów w formacie ISO 8601. Może to być np. data premiery filmu lub albumu muzycznego.

- (NSString* const) kGCKMetadataKeyBroadcastDate

Klucz ciągu tekstowego: data transmisji.

Wartość to data lub godzina pierwszej emisji treści w formacie ISO 8601. Może to być np. data pierwszej emisji odcinka programu telewizyjnego.

- (NSString* const) kGCKMetadataKeyTitle

Klucz ciągu tekstowego: Title.

Tytuł materiału. Może to być na przykład tytuł utworu, filmu lub odcinka serialu. Ta wartość nadaje się do wyświetlania.

- (NSString* const) kGCKMetadataKeySubtitle

Klucz ciągu znaków: Subtitle.

Podtytuł multimediów. Ta wartość nadaje się do wyświetlania.

- (NSString* const) kGCKMetadataKeyArtist

Klucz ciągu znaków: wykonawca.

Nazwa wykonawcy, który stworzył media. Może to być na przykład nazwa wykonawcy, muzyka lub fotografa. Ta wartość nadaje się do wyświetlania.

- (NSString* const) kGCKMetadataKeyAlbumArtist

Klucz ciągu tekstowego: wykonawca albumu.

Nazwa wykonawcy, który wydał album. Na przykład w przypadku albumów kompilacyjnych, takich jak miksy DJ-skie, wykonawca albumu niekoniecznie jest tym samym wykonawcą co poszczególne utwory na albumie. Ta wartość nadaje się do wyświetlania.

- (NSString* const) kGCKMetadataKeyAlbumTitle

Klucz ciągu znaków: tytuł albumu.

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

- (NSString* const) kGCKMetadataKeyComposer

Klucz ciągu znaków: Composer.

Imię i nazwisko kompozytora utworu muzycznego. Ta wartość nadaje się do wyświetlania.

- (NSString* const) kGCKMetadataKeyDiscNumber

Klucz liczby całkowitej: numer płyty.

Numer płyty (liczony od 1), do której należy utwór muzyczny w albumie wielopłytowym.

- (NSString* const) kGCKMetadataKeyTrackNumber

Klucz liczby całkowitej: numer utworu.

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

- (NSString* const) kGCKMetadataKeySeasonNumber

Klucz w formie liczby całkowitej: numer sezonu.

Numer sezonu, do którego należy odcinek programu telewizyjnego. Zazwyczaj numery sezonów są liczone od 1, ale ta wartość może wynosić 0, jeśli jest to odcinek „pilotowy”, który poprzedza oficjalny początek serialu.

- (NSString* const) kGCKMetadataKeyEpisodeNumber

Klucz w formie liczby całkowitej: numer odcinka.

Numer odcinka w danym sezonie programu telewizyjnego. Numery odcinków są zwykle liczone od 1, ale ta wartość może wynosić 0, jeśli jest to odcinek „pilotowy”, który nie jest uważany za oficjalny odcinek pierwszego sezonu.

- (NSString* const) kGCKMetadataKeySeriesTitle

Klucz tekstowy: tytuł serii.

Nazwa serii. Może to być na przykład nazwa programu telewizyjnego lub serii powiązanych albumów muzycznych. Ta wartość nadaje się do wyświetlania.

- (NSString* const) kGCKMetadataKeyStudio

Klucz ciągu znaków: Studio.

Nazwa studia nagrań, które wyprodukowało dany materiał. Może to być na przykład nazwa studia filmowego lub wytwórni muzycznej. Ta wartość nadaje się do wyświetlania.

- (NSString* const) kGCKMetadataKeyWidth

Klucz liczby całkowitej: szerokość.

Szerokość elementu multimedialnego w pikselach. Zwykle jest to używane do podawania wymiarów zdjęcia.

- (NSString* const) kGCKMetadataKeyHeight

Klucz liczby całkowitej: wysokość.

Wysokość elementu multimedialnego w pikselach. Zwykle jest to używane do podawania wymiarów zdjęcia.

- (NSString* const) kGCKMetadataKeyLocationName

Klucz ciągu tekstowego: nazwa lokalizacji.

Nazwa miejsca, w którym powstał plik multimedialny. Może to być na przykład lokalizacja zdjęcia lub główne miejsce kręcenia filmu. Ta wartość nadaje się do wyświetlania.

- (NSString* const) kGCKMetadataKeyLocationLatitude

Klucz podwójny: szerokość geograficzna lokalizacji.

Szerokość geograficzna miejsca, w którym utworzono element multimedialny. Może to być na przykład lokalizacja zdjęcia lub główne miejsce kręcenia filmu.

- (NSString* const) kGCKMetadataKeyLocationLongitude

Klucz podwójny: długość geograficzna lokalizacji.

Składnik długości geograficznej lokalizacji, w której utworzono element multimedialny. Może to być na przykład lokalizacja zdjęcia lub główne miejsce kręcenia filmu.

Szczegóły usługi

- (GCKMediaMetadataType) metadataType

readnonatomicassign

Typ metadanych.

Klasa GCKMediaMetadata Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Przegląd

Podsumowanie metod instancji

Atrybuty publiczne

Podsumowanie usługi

Szczegóły metody

Dokumentacja danych użytkowników

Szczegóły usługi

Klasa GCKMediaMetadata