Класс GCKMediaMetadata

Справочник по классу GCKMediaMetadata

Обзор

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

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

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

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

(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
metadataTypeThe 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
imageThe image to add.
- (BOOL) containsKey: (NSString *)  key

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

Parameters
keyThe key.
Возврат
YES если поле существует, в противном случае NO .
- (NSArray<NSString *> *) allKeys

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

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

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

Parameters
keyThe key for the field.
Возврат
Значение поля или nil , если поле не было установлено.
- (void) setString: (NSString *)  value
forKey: (NSString *)  key  

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

Parameters
valueThe new value for the field.
keyThe key for the field.
Исключения
NSInvalidArgumentException если ключ относится к предопределенному полю, которое не является строковым полем.
- (NSString *__nullable) stringForKey: (NSString *)  key

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

Parameters
keyThe key for the field.
Возврат
Значение поля или nil , если поле не было установлено.
Исключения
NSInvalidArgumentException если ключ относится к предопределенному полю, которое не является строковым полем.
- (void) setInteger: (NSInteger)  value
forKey: (NSString *)  key  

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

Parameters
valueThe new value for the field.
keyThe key for the field.
Исключения
NSInvalidArgumentException если ключ относится к предопределенному полю, которое не является целочисленным полем.
- (NSInteger) integerForKey: (NSString *)  key

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

Parameters
keyThe key for the field.
Возврат
Значение поля или 0, если поле не задано.
Исключения
NSInvalidArgumentException если ключ относится к предопределенному полю, которое не является целочисленным полем.
- (NSInteger) integerForKey: (NSString *)  key
defaultValue: (NSInteger)  defaultValue  

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

Parameters
keyThe key for the field.
defaultValueThe value to return if the field has not been set.
Возврат
Значение поля или заданное значение по умолчанию, если поле не было установлено.
Исключения
NSInvalidArgumentException если ключ относится к предопределенному полю, которое не является целочисленным полем.
- (void) setDouble: (double)  value
forKey: (NSString *)  key  

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

Parameters
valueThe new value for the field.
keyThe key for the field.
Исключения
NSInvalidArgumentException если ключ относится к предопределенному полю, которое не является двойным полем.
- (double) doubleForKey: (NSString *)  key

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

Parameters
keyThe key for the field.
Возврат
Значение поля или 0, если поле не задано.
Исключения
NSInvalidArgumentException если ключ относится к предопределенному полю, которое не является двойным полем.
- (double) doubleForKey: (NSString *)  key
defaultValue: (double)  defaultValue  

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

Parameters
defaultValueThe value to return if the field has not been set.
keyThe key for the field.
Возврат
Значение поля или заданное значение по умолчанию, если поле не было установлено.
Исключения
NSInvalidArgumentException если ключ относится к предопределенному полю, которое не является двойным полем.
- (void) setDate: (NSDate *)  date
forKey: (NSString *)  key  

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

Parameters
dateThe new value for the field.
keyThe key for the field.
Исключения
NSInvalidArgumentException если ключ относится к предопределенному полю, которое не является полем даты.
- (NSDate *__nullable) dateForKey: (NSString *)  key

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

Parameters
keyThe field name.
Возврат
Дата или nil , если это поле не задано.
Исключения
NSInvalidArgumentException если ключ относится к предопределенному полю, которое не является полем даты.
- (NSString *__nullable) dateAsStringForKey: (NSString *)  key

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

Parameters
keyThe 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

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