Обзор

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

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

Значения предопределенных полей имеют предопределенные типы. Например, номер дорожки — это 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>.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

(NSString *__nullable)	- 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
	Двойная клавиша: долгота местоположения. Более...

Сводка свойств
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

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

- (id __nullable) 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 если ключ относится к предварительно определенному полю, которое не является строковым полем.

- (NSString *__nullable) 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 если ключ относится к предварительно определенному полю, которое не является полем даты.

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

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

Parameters

key	The field name.

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

Исключения

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

- (NSString *__nullable) 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

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

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

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

- ( GCKMediaMetadataType ) metadataType

read nonatomic assign

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

Класс GCKMediaMetadata

Обзор

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

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

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

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

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

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