Обзор

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

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

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

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

Поле	Тип значения	Допустимые типы метаданных
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	двойной	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

Обзор

Резюме метода экземпляра

Общедоступные атрибуты

Сводка свойств

Сведения о методе

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

Сведения о собственности