Обзор

Контейнер для метаданных мультимедиа.

Метаданные имеют тип носителя, необязательный список изображений и коллекцию полей метаданных. Ключи для общих полей метаданных предопределены как константы, но приложение может свободно определять и использовать дополнительные поля самостоятельно.

Значения предопределенных полей имеют предопределенные типы. Например, номер дорожки — это NSInteger , а дата создания — это NSString , содержащий представление даты и времени в формате ISO-8601. Попытка сохранить в поле значение неправильного типа приведет к возникновению исключения NSInvalidArgumentException .

Обратите внимание, что протокол Cast ограничивает количество полей метаданных, которые можно использовать для данного типа мультимедиа. Когда объект MediaMetadata сериализуется в JSON для доставки получателю Cast, любые предопределенные поля, которые не поддерживаются для данного типа мультимедиа, не будут включены в сериализованную форму, но любые поля, определенные приложением, всегда будут включены. Полный список предопределенных полей выглядит следующим образом:

Поле	Тип значения	Допустимые типы метаданных
kGCKMetadataKeyCreationDate	НСДата	GCKMediaMetadataTypePhoto
kGCKMetadataKeyReleaseDate	НСДата	GCKMediaMetadataTypeGeneric , GCKMediaMetadataTypeMovie , GCKMediaMetadataTypeTVShow , GCKMediaMetadataTypeMusicTrack
kGCKMetadataKeyBroadcastDate	НСДата	GCKMediaMetadataTypeTVShow
kGCKMetadataKeyTitle	НСстринг	GCKMediaMetadataTypeGeneric , GCKMediaMetadataTypeMovie , GCKMediaMetadataTypeTVShow , GCKMediaMetadataTypeMusicTrack , GCKMediaMetadataTypePhoto
kGCKMetadataKeySubtitle	НСстринг	GCKMediaMetadataTypeGeneric , GCKMediaMetadataTypeMovie
kGCKMetadataKeyArtist	НСстринг	GCKMediaMetadataTypeGeneric , GCKMediaMetadataTypeMusicTrack , GCKMediaMetadataTypePhoto
kGCKMetadataKeyAlbumArtist	НСстринг	GCKMediaMetadataTypeMusicTrack
kGCKMetadataKeyAlbumTitle	НСстринг	GCKMediaMetadataTypeMusicTrack
kGCKMetadataKeyComposer	НСстринг	GCKMediaMetadataTypeMusicTrack
kGCKMetadataKeyDiscNumber	НСинтегер	GCKMediaMetadataTypeMusicTrack
kGCKMetadataKeyTrackNumber	НСинтегер	GCKMediaMetadataTypeMusicTrack
kGCKMetadataKeySeasonNumber	НСинтегер	GCKMediaMetadataTypeTVShow
kGCKMetadataKeyEpisodeNumber	НСинтегер	GCKMediaMetadataTypeTVShow
kGCKMetadataKeySeriesTitle	НСстринг	GCKMediaMetadataTypeTVShow
kGCKMetadataKeyStudio	НСстринг	GCKMediaMetadataTypeMovie
kGCKMetadataKeyWidth	НСинтегер	GCKMediaMetadataTypePhoto
kGCKMetadataKeyHeight	НСинтегер	GCKMediaMetadataTypePhoto
kGCKMetadataKeyLocationName	НСстринг	GCKMediaMetadataTypePhoto
kGCKMetadataKeyLocationLatitude	двойной	GCKMediaMetadataTypePhoto
kGCKMetadataKeyLocationLongitude	двойной	GCKMediaMetadataTypePhoto

Наследует NSObject, <NSCopying> и <NSSecureCoding>.

Сводка метода экземпляра
(instancetype)	- initWithMetadataType:
	Инициализирует новый пустой объект MediaMetadata с заданным типом носителя. Более...

(instancetype)	- init
	Инициализируйте с помощью общего типа метаданных. Более...

( GCKMediaMetadataType )	- metadataType
	Тип метаданных. Более...

(NSArray *)	- images
	Получает список изображений. Более...

(void)	- removeAllMediaImages
	Удаляет все текущие изображения. Более...

(void)	- addImage:
	Добавляет изображение в список изображений. Более...

(BOOL)	- containsKey:
	Проверяет, содержит ли объект поле с заданным ключом. Более...

(NSArray< NSString * > *)	- allKeys
	Возвращает набор ключей для всех полей, присутствующих в объекте. Более...

(nullable id)	- objectForKey:
	Считывает значение поля. Более...

(void)	- setString:forKey:
	Сохраняет значение в строковом поле. Более...

(nullable NSString *)	- stringForKey:
	Считывает значение строкового поля. Более...

(void)	- setInteger:forKey:
	Сохраняет значение в целочисленном поле. Более...

(NSInteger)	- integerForKey:
	Считывает значение целочисленного поля. Более...

(NSInteger)	- integerForKey:defaultValue:
	Считывает значение целочисленного поля. Более...

(void)	- setDouble:forKey:
	Сохраняет значение в двойном поле. Более...

(double)	- doubleForKey:
	Считывает значение двойного поля. Более...

(double)	- doubleForKey:defaultValue:
	Считывает значение двойного поля. Более...

(void)	- setDate:forKey:
	Сохраняет значение в поле даты как ограниченное представление даты согласно ISO-8601. Более...

(nullable NSDate *)	- dateForKey:
	Считывает значение поля даты из ограниченного представления даты ISO-8601. Более...

(nullable NSString *)	- dateAsStringForKey:
	Считывает значение поля даты в виде строки. Более...

Публичные атрибуты
NSString *const	kGCKMetadataKeyCreationDate
	Строковый ключ: дата создания. Более...

NSString *const	kGCKMetadataKeyReleaseDate
	Строковый ключ: Дата выпуска. Более...

NSString *const	kGCKMetadataKeyBroadcastDate
	Строковый ключ: дата трансляции. Более...

NSString *const	kGCKMetadataKeyTitle
	Строковый ключ: Название. Более...

NSString *const	kGCKMetadataKeySubtitle
	Строковый ключ: Подзаголовок. Более...

NSString *const	kGCKMetadataKeyArtist
	Строковый ключ: Художник. Более...

NSString *const	kGCKMetadataKeyAlbumArtist
	Строковый ключ: исполнитель альбома. Более...

NSString *const	kGCKMetadataKeyAlbumTitle
	Строковый ключ: название альбома. Более...

NSString *const	kGCKMetadataKeyComposer
	Строковый ключ: Композитор. Более...

NSString *const	kGCKMetadataKeyDiscNumber
	Целочисленный ключ: номер диска. Более...

NSString *const	kGCKMetadataKeyTrackNumber
	Целочисленный ключ: номер трека. Более...

NSString *const	kGCKMetadataKeySeasonNumber
	Целочисленный ключ: номер сезона. Более...

NSString *const	kGCKMetadataKeyEpisodeNumber
	Целочисленный ключ: номер эпизода. Более...

NSString *const	kGCKMetadataKeySeriesTitle
	Строковый ключ: название серии. Более...

NSString *const	kGCKMetadataKeyStudio
	Строковый ключ: Студия. Более...

NSString *const	kGCKMetadataKeyWidth
	Целочисленный ключ: Ширина. Более...

NSString *const	kGCKMetadataKeyHeight
	Целочисленный ключ: Высота. Более...

NSString *const	kGCKMetadataKeyLocationName
	Строковый ключ: название местоположения. Более...

NSString *const	kGCKMetadataKeyLocationLatitude
	Двойной ключ: широта местоположения. Более...

NSString *const	kGCKMetadataKeyLocationLongitude
	Двойной ключ: долгота местоположения. Более...

NSString *const	kGCKMetadataKeyBookTitle
	Строковый ключ: Название книги. Более...

NSString *const	kGCKMetadataKeyChapterNumber
	Целочисленный ключ: номер главы. Более...

NSString *const	kGCKMetadataKeyChapterTitle
	Строковый ключ: название главы. Более...

NSString *const	kGCKMetadataKeySectionDuration
	Двойной ключ: Продолжительность раздела. Более...

NSString *const	kGCKMetadataKeySectionStartTimeInMedia
	Двойной ключ: Время начала раздела в медиа. Более...

NSString *const	kGCKMetadataKeySectionStartAbsoluteTime
	Двойная клавиша: Раздел «Абсолютное время начала». Более...

NSString *const	kGCKMetadataKeySectionStartTimeInContainer
	Двойной ключ: Время начала раздела в контейнере. Более...

NSString *const	kGCKMetadataKeyQueueItemID
	Двойной ключ: идентификатор элемента очереди. Более...

Сводная информация о недвижимости
GCKMediaMetadataType	metadataType
	Тип метаданных. Более...

Подробности метода

- (instancetype) initWithMetadataType: ( GCKMediaMetadataType ) metadataType

Инициализирует новый пустой объект MediaMetadata с заданным типом носителя.

Назначенный инициализатор.

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

Инициализируйте с помощью общего типа метаданных.

- ( GCKMediaMetadataType ) metadataType

Тип метаданных.

- (NSArray *) images

Получает список изображений.

- (void) removeAllMediaImages

Удаляет все текущие изображения.

- (void) addImage: ( GCKImage *) image

Добавляет изображение в список изображений.

Parameters

image The image to add.

- (BOOL) containsKey: (NSString *) key

Проверяет, содержит ли объект поле с заданным ключом.

Parameters

key The key.

Возврат: YES , если поле существует, в противном случае NO .

- (NSArray<NSString *> *) allKeys

Возвращает набор ключей для всех полей, присутствующих в объекте.

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

Считывает значение поля.

Parameters

key	The key for the field.

Возврат: Значение поля или nil , если поле не было установлено.

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

Сохраняет значение в строковом поле.

Parameters

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

Исключения

NSInvalidArgumentException если ключ относится к предопределенному полю, которое не является строковым полем.

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

Считывает значение строкового поля.

Parameters

key	The key for the field.

Возврат: Значение поля или nil , если поле не было установлено.

Исключения

NSInvalidArgumentException если ключ относится к предопределенному полю, которое не является строковым полем.

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

Сохраняет значение в целочисленном поле.

Parameters

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

Исключения

NSInvalidArgumentException если ключ относится к предопределенному полю, которое не является целочисленным полем.

- (NSInteger) integerForKey: (NSString *) key

Считывает значение целочисленного поля.

Parameters

key	The key for the field.

Возврат: Значение поля или 0, если поле не задано.

Исключения

NSInvalidArgumentException если ключ относится к предопределенному полю, которое не является целочисленным полем.

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

Считывает значение целочисленного поля.

Parameters

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

Возврат: Значение поля или заданное значение по умолчанию, если поле не было установлено.

Исключения

NSInvalidArgumentException если ключ относится к предопределенному полю, которое не является целочисленным полем.

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

Сохраняет значение в двойном поле.

Parameters

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

Исключения

NSInvalidArgumentException если ключ относится к предопределенному полю, которое не является двойным полем.

- (double) doubleForKey: (NSString *) key

Считывает значение двойного поля.

Parameters

key	The key for the field.

Возврат: Значение поля или 0, если поле не задано.

Исключения

NSInvalidArgumentException если ключ относится к предопределенному полю, которое не является двойным полем.

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

Считывает значение двойного поля.

Parameters

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

Возврат: Значение поля или заданное значение по умолчанию, если поле не было установлено.

Исключения

NSInvalidArgumentException если ключ относится к предопределенному полю, которое не является двойным полем.

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

Сохраняет значение в поле даты как ограниченное представление даты согласно ISO-8601.

Parameters

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

Исключения

NSInvalidArgumentException если ключ относится к предопределенному полю, которое не является полем даты.

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

Считывает значение поля даты из ограниченного представления даты ISO-8601.

Parameters

key	The field name.

Возврат: Дата или nil , если это поле не задано.

Исключения

NSInvalidArgumentException если ключ относится к предопределенному полю, которое не является полем даты.

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

Считывает значение поля даты в виде строки.

Parameters

key	The field name.

Возврат: Дата в виде строки, содержащей ограниченное представление даты ISO-8601, или nil если это поле не установлено.

Исключения

NSInvalidArgumentException если ключ относится к предопределенному полю, которое не является полем даты.

Документация по данным участников

- (NSString* const) kGCKMetadataKeyCreationDate

Строковый ключ: дата создания.

Значением является дата и/или время создания носителя в формате ISO-8601. Например, это может быть дата и время, когда была сделана фотография или записано музыкальное произведение.

- (NSString* const) kGCKMetadataKeyReleaseDate

Строковый ключ: Дата выпуска.

Значением является дата и/или время выпуска носителя в формате ISO-8601. Например, это может быть дата выхода фильма или музыкального альбома.

- (NSString* const) kGCKMetadataKeyBroadcastDate

Строковый ключ: дата трансляции.

Значением является дата и/или время первой трансляции мультимедиа в формате ISO-8601. Например, это может быть дата первого выхода в эфир эпизода телешоу.

- (NSString* const) kGCKMetadataKeyTitle

Строковый ключ: Название.

Название СМИ. Например, это может быть название песни, фильма или серии телешоу. Это значение подходит для отображения.

- (NSString* const) kGCKMetadataKeySubtitle

Строковый ключ: Подзаголовок.

Подзаголовок СМИ. Это значение подходит для отображения.

- (NSString* const) kGCKMetadataKeyArtist

Строковый ключ: Художник.

Имя художника, создавшего носитель. Например, это может быть имя музыканта, исполнителя или фотографа. Это значение подходит для отображения.

- (NSString* const) kGCKMetadataKeyAlbumArtist

Строковый ключ: исполнитель альбома.

Имя исполнителя, выпустившего альбом. Например, в сборниках, таких как DJ-миксы, исполнитель альбома не обязательно совпадает с исполнителем(ами) отдельных песен в альбоме. Это значение подходит для отображения.

- (NSString* const) kGCKMetadataKeyAlbumTitle

Строковый ключ: название альбома.

Название альбома, которому принадлежит музыкальный трек. Это значение подходит для отображения.

- (NSString* const) kGCKMetadataKeyComposer

Строковый ключ: Композитор.

Имя композитора музыкального трека. Это значение подходит для отображения.

- (NSString* const) kGCKMetadataKeyDiscNumber

Целочисленный ключ: номер диска.

Номер диска (считая с 1), которому принадлежит музыкальная дорожка в многодисковом альбоме.

- (NSString* const) kGCKMetadataKeyTrackNumber

Целочисленный ключ: номер трека.

Номер музыкальной дорожки на диске альбома. Обычно номера треков отсчитываются с 1, однако это значение может быть равно 0, если это «скрытый трек» в начале альбома.

- (NSString* const) kGCKMetadataKeySeasonNumber

Целочисленный ключ: номер сезона.

Номер сезона, к которому принадлежит серия телешоу. Обычно номера сезонов отсчитываются с 1, однако это значение может быть равно 0, если это «пилотный» эпизод, предшествовавший официальному началу сериала.

- (NSString* const) kGCKMetadataKeyEpisodeNumber

Целочисленный ключ: номер эпизода.

Номер серии в данном сезоне телешоу. Обычно номера серий отсчитываются с 1, однако это значение может быть равно 0, если это «пилотная» серия, которая не считается официальной серией первого сезона.

- (NSString* const) kGCKMetadataKeySeriesTitle

Строковый ключ: название серии.

Название серии. Например, это может быть название телешоу или серии связанных музыкальных альбомов. Это значение подходит для отображения.

- (NSString* const) kGCKMetadataKeyStudio

Строковый ключ: Студия.

Название студии звукозаписи, выпустившей носитель. Например, это может быть название киностудии или музыкального лейбла. Это значение подходит для отображения.

- (NSString* const) kGCKMetadataKeyWidth

Целочисленный ключ: Ширина.

Ширина фрагмента носителя в пикселях. Обычно это используется для указания размеров фотографии.

- (NSString* const) kGCKMetadataKeyHeight

Целочисленный ключ: Высота.

Высота фрагмента мультимедиа в пикселях. Обычно это используется для указания размеров фотографии.

- (NSString* const) kGCKMetadataKeyLocationName

Строковый ключ: название местоположения.

Имя места, где был создан медиафайл. Например, это может быть место съемки фотографии или основное место съемок фильма. Это значение подходит для отображения.

- (NSString* const) kGCKMetadataKeyLocationLatitude

Двойной ключ: широта местоположения.

Широтный компонент географического местоположения, где был создан медиафайл. Например, это может быть место съемки фотографии или основное место съемок фильма.

- (NSString* const) kGCKMetadataKeyLocationLongitude

Двойной ключ: долгота местоположения.

Компонент долготы географического местоположения, где был создан медиафайл. Например, это может быть место съемки фотографии или основное место съемок фильма.

- (NSString* const) kGCKMetadataKeyBookTitle

Строковый ключ: Название книги.

Название аудиокниги.

С: 4.3.5

- (NSString* const) kGCKMetadataKeyChapterNumber

Целочисленный ключ: номер главы.

Номер главы в аудиокниге.

С: 4.3.5

- (NSString* const) kGCKMetadataKeyChapterTitle

Строковый ключ: название главы.

Название главы в аудиокниге.

С: 4.3.5

- (NSString* const) kGCKMetadataKeySectionDuration

Двойной ключ: Продолжительность раздела.

Длительность раздела в секундах. Используется для метаданных очереди. Например, это может быть продолжительность одной телепередачи в очереди, продолжительность главы аудиокниги или программы длинного прямого эфира.

С: 4.4.1

- (NSString* const) kGCKMetadataKeySectionStartTimeInMedia

Двойной ключ: Время начала раздела в медиа.

Смещение времени начала раздела от начала медиа-элемента в секундах. Используется для метаданных очереди.

С: 4.4.1

- (NSString* const) kGCKMetadataKeySectionStartAbsoluteTime

Двойная клавиша: Раздел «Абсолютное время начала».

Абсолютное время начала раздела в эпохе в секундах. Используется для метаданных очереди.

С: 4.4.1

- (NSString* const) kGCKMetadataKeySectionStartTimeInContainer

Двойной ключ: Время начала раздела в контейнере.

Смещение времени начала раздела внутри полного контейнера. Используется для метаданных очереди.

С: 4.4.1

- (NSString* const) kGCKMetadataKeyQueueItemID

Двойной ключ: идентификатор элемента очереди.

Идентификатор элемента очереди, включающий время начала раздела. Используется для метаданных очереди.

С: 4.4.1

Детали недвижимости

- ( GCKMediaMetadataType ) metadataType

read nonatomic assign

Тип метаданных.

Класс GCKMediaMetadata Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

Обзор

Сводка метода экземпляра

Публичные атрибуты

Сводная информация о недвижимости

Подробности метода

Документация по данным участников

Детали недвижимости

Класс GCKMediaMetadata