Обзор
Контейнер для метаданных мультимедиа.
Метаданные имеют тип носителя, необязательный список изображений и коллекцию полей метаданных. Ключи для общих полей метаданных предопределены как константы, но приложение может свободно определять и использовать дополнительные поля самостоятельно.
Значения предопределенных полей имеют предопределенные типы. Например, номер дорожки — это NSInteger
, а дата создания — это NSString, содержащий представление даты и времени в формате ISO-8601. Попытка сохранить в поле значение неправильного типа приведет к возникновению исключения NSInvalidArgumentException .
Обратите внимание, что протокол Cast ограничивает количество полей метаданных, которые можно использовать для данного типа мультимедиа. Когда объект MediaMetadata сериализуется в JSON для доставки получателю Cast, любые предопределенные поля, которые не поддерживаются для данного типа мультимедиа, не будут включены в сериализованную форму, но любые поля, определенные приложением, всегда будут включены. Полный список предопределенных полей выглядит следующим образом:
Наследует 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 |
Двойной ключ: долгота местоположения.
Компонент долготы географического местоположения, где был создан медиафайл. Например, это может быть место съемки фотографии или основное место съемок фильма.
Детали недвижимости
|
read nonatomic assign |
Тип метаданных.