Spec-Zone .ru
спецификации, руководства, описания, API

Библиотека Разработчика iOS

Разработчик

Ссылка платформы AVFoundation ссылка класса AVMetadataItem

Опции
Развертывание Target:

На этой странице
Язык:

AVMetadataItem

Наследование


Оператор импорта


Swift

import AVFoundation

Objective C

@import AVFoundation;

Доступность


Доступный в iOS 4.0 и позже.

AVMetadataItem объект представляет элемент метаданных, связанных с аудиовизуальным активом или с одной из его дорожек. Для создания элементов метаданных для собственных активов Вы используете непостоянный подкласс, AVMutableMetadataItem.

Элементы метаданных имеют ключи, согласующиеся со спецификацией формата контейнера, из которого они привлечены. Полное изложение форматов метаданных, ключей метаданных и ключевых пространств метаданных, поддерживаемых Основой AV, доступно среди определения в Ключевой Ссылке Констант Метаданных Основы AV и Основе AV Константы Метаданных iTunes.

Можно загрузить значения элемента метаданных «лениво» с помощью методов от AVAsynchronousKeyValueLoading протокол (см. Асинхронную Загрузку). AVAsset класс и другие классы поочередно обеспечивают их метаданные лениво так, чтобы можно было получить объекты из тех массивов, не подвергаясь наверху для элементов, которые Вы в конечном счете не проверяете.

Можно отфильтровать массивы элементов метаданных с помощью методов этого класса. Например, можно отфильтровать ключевым и ключевым пространством локалью, и предпочтительным языком.

  • key Свойство

    Ключ элемента метаданных. (только для чтения)

    Объявление

    Swift

    @NSCopying var key: protocol<NSCopying, NSObjectProtocol>! { get }

    Objective C

    @property(readonly, copy) id<NSObject, NSCopying> key

    Обсуждение

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

    Оператор импорта

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в iOS 4.0 и позже.

  • keySpace Свойство

    Ключевое пространство ключа элемента метаданных. (только для чтения)

    Объявление

    Swift

    var keySpace: String! { get }

    Objective C

    @property(readonly, copy) NSString *keySpace

    Обсуждение

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

    Основа AV использует ключевые пространства для группировки связанных наборов ключей. Например, платформа определяет различные ключевые пространства для общих ключей, ключей iTunes, ключей ID3 и ключей QuickTime. Ключевые пространства помогают в фильтрации массивов элементов метаданных.

    Оператор импорта

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в iOS 4.0 и позже.

  • commonKey Свойство

    Общий ключ элемента метаданных. (только для чтения)

    Объявление

    Swift

    var commonKey: String! { get }

    Objective C

    @property(readonly, copy) NSString *commonKey

    Обсуждение

    Это свойство содержит ключ, наиболее близко соответствующий ключу key свойство, но это принадлежит общему ключевому пространству (AVMetadataKeySpaceCommon) в противоположность специфичному для формата ключевому пространству. Можно использовать этот ключ для определения местоположения элементов метаданных независимо от базового формата носителя.

    Если значение keySpace свойство AVMetadataKeySpaceCommon, это свойство содержит тот же ключ как key свойство.

    Оператор импорта

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в iOS 4.0 и позже.

  • Говорит получателю загружать значения любого из уже не загружающихся указанных ключей.

    Объявление

    Swift

    func loadValuesAsynchronouslyForKeys(_ keys: [AnyObject]!, completionHandler handler: (() -> Void)!)

    Objective C

    - (void)loadValuesAsynchronouslyForKeys:(NSArray *)keys completionHandler:(void (^)(void))handler

    Параметры

    keys

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

    handler

    Блок, который будет вызван, когда загрузка успешно выполняется, перестал работать или отменяется.

    Обсуждение

    Для полного обсуждения посмотрите AVAsynchronousKeyValueLoading.

    Оператор импорта

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в iOS 4.2 и позже.

  • Отчеты, доступно ли значение для данного ключа сразу без блокирования.

    Объявление

    Swift

    func statusOfValueForKey(_ key: String!, error outError: NSErrorPointer) -> AVKeyValueStatus

    Objective C

    - (AVKeyValueStatus)statusOfValueForKey:(NSString *)key error:(NSError **)outError

    Параметры

    key

    Ключ, состояние которого Вы хотите.

    outError

    Если состояние значения для ключа AVKeyValueStatusFailed, по возврату содержит NSError объект, описывающий произошедший отказ.

    Возвращаемое значение

    Текущее состояние загрузки значения для key.

    Обсуждение

    Для полного обсуждения посмотрите AVAsynchronousKeyValueLoading.

    Оператор импорта

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в iOS 4.2 и позже.

  • value Свойство

    Значение элемента метаданных. (только для чтения)

    Объявление

    Swift

    @NSCopying var value: protocol<NSCopying, NSObjectProtocol>! { get }

    Objective C

    @property(readonly, copy) id<NSObject, NSCopying> value

    Оператор импорта

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в iOS 4.0 и позже.

  • time Свойство

    Метка времени элемента метаданных. (только для чтения)

    Объявление

    Swift

    var time: CMTime { get }

    Objective C

    @property(readonly) CMTime time

    Оператор импорта

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в iOS 4.0 и позже.

  • duration Свойство

    Продолжительность элемента метаданных. (только для чтения)

    Объявление

    Swift

    var duration: CMTime { get }

    Objective C

    @property(readonly) CMTime duration

    Оператор импорта

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в iOS 4.2 и позже.

  • locale Свойство

    Локаль элемента метаданных. (только для чтения)

    Объявление

    Swift

    @NSCopying var locale: NSLocale! { get }

    Objective C

    @property(readonly, copy) NSLocale *locale

    Обсуждение

    Локаль может быть nil если никакая информация о локали не доступна для элемента метаданных.

    Оператор импорта

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в iOS 4.0 и позже.

  • dataValue Свойство

    Обеспечивает необработанные байты значения элемента метаданных. (только для чтения)

    Объявление

    Swift

    var dataValue: NSData! { get }

    Objective C

    @property(readonly) NSData *dataValue

    Оператор импорта

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в iOS 4.0 и позже.

  • extraAttributes Свойство

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

    Объявление

    Swift

    var extraAttributes: [NSObject : AnyObject]! { get }

    Objective C

    @property(readonly, copy) NSDictionary *extraAttributes

    Обсуждение

    Дополнительные атрибуты, когда они присутствуют, являются определенными для форматов контейнера метаданных, и вводит их связанные ключевые пространства. Например, «присоединенное изображение» кадр, определенный спецификацией тега ID3, может быть представлено AVMetadataItem с ключевым пространством AVMetadataKeySpaceID3, ключ AVMetadataID3MetadataKeyAttachedPicture, значение, переносящее данные изображения и дополнительные атрибуты, включающие описание изображения, как перенесено в кадре 'APIC' тега ID3.

    Оператор импорта

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в iOS 4.0 и позже.

  • dataType Свойство

    Указывает тип данных значения элемента метаданных. (только для чтения)

    Объявление

    Swift

    var dataType: String! { get }

    Objective C

    @property(readonly, copy) NSString *dataType

    Оператор импорта

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в iOS 8.0 и позже.

  • extendedLanguageTag Свойство

    IETF BCP 47 (RFC 4646) идентификатор языка элемента метаданных. (только для чтения)

    Объявление

    Swift

    var extendedLanguageTag: String! { get }

    Objective C

    @property(readonly, copy) NSString *extendedLanguageTag

    Обсуждение

    Значение может быть nil если никакая информация о языковом теге не доступна.

    Оператор импорта

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в iOS 8.0 и позже.

  • identifier Свойство

    Указывает идентификатор элемента метаданных. (только для чтения)

    Объявление

    Swift

    var identifier: String! { get }

    Objective C

    @property(readonly, copy) NSString *identifier

    Оператор импорта

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в iOS 8.0 и позже.

  • Обеспечивает идентификатор метаданных, это эквивалентно ключевому и ключевому пространству.

    Объявление

    Swift

    class func identifierForKey(_ key: AnyObject!, keySpace keySpace: String!) -> String!

    Objective C

    + (NSString *)identifierForKey:(id)key keySpace:(NSString *)keySpace

    Параметры

    key

    Ключ метаданных.

    keySpace

    Ключевое пространство метаданных.

    Возвращаемое значение

    Идентификатор метаданных, эквивалентный key и keySpace, или nil если не может быть создан никакой идентификатор

    Обсуждение

    Ключи метаданных, которые не являются экземплярами NSString, NSNumber, или NSData не может быть преобразован в идентификаторы метаданных; они также не могут быть записаны в медиаресурсы через AVAssetExportSession или AVAssetWriter. Элемент метаданных keySpaces должна быть строка одного - четырех печатаемых символов ASCII.

    Для пользовательских идентификаторов, keySpace AVMetadataKeySpaceQuickTimeMetadata рекомендуется. Это keySpace определяет его значения ключа, которые будут выражены как строки обратного DNS, который позволяет третьим лицам определять свои собственные ключи в хорошо установленном пути, избегающем коллизий.

    Оператор импорта

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в iOS 8.0 и позже.

  • Возвращает ключ метаданных, обозначенный идентификатором.

    Объявление

    Swift

    class func keyForIdentifier(_ identifier: String!) -> AnyObject!

    Objective C

    + (id)keyForIdentifier:(NSString *)identifier

    Параметры

    identifier

    Идентификатор метаданных.

    Возвращаемое значение

    Ключ метаданных.

    Оператор импорта

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в iOS 8.0 и позже.

  • Возвращает ключевое пространство метаданных, обозначенное идентификатором.

    Объявление

    Swift

    class func keySpaceForIdentifier(_ identifier: String!) -> String!

    Objective C

    + (NSString *)keySpaceForIdentifier:(NSString *)identifier

    Параметры

    identifier

    Идентификатор метаданных.

    Возвращаемое значение

    Ключ метаданных.

    Оператор импорта

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в iOS 8.0 и позже.

  • stringValue Свойство

    Значение элемента метаданных, отформатированного как строка. (только для чтения)

    Объявление

    Swift

    var stringValue: String! { get }

    Objective C

    @property(readonly) NSString *stringValue

    Обсуждение

    Значение этого свойства nil если значение метаданных не может быть представлено как строка.

    Оператор импорта

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в iOS 4.0 и позже.

  • numberValue Свойство

    Значение элемента метаданных, отформатированного как число. (только для чтения)

    Объявление

    Swift

    var numberValue: NSNumber! { get }

    Objective C

    @property(readonly) NSNumber *numberValue

    Обсуждение

    Значение этого свойства nil если значение метаданных не может быть представлено как число.

    Оператор импорта

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в iOS 4.0 и позже.

  • dateValue Свойство

    Значение элемента метаданных, отформатированного как дата. (только для чтения)

    Объявление

    Swift

    var dateValue: NSDate! { get }

    Objective C

    @property(readonly) NSDate *dateValue

    Обсуждение

    Значение этого свойства nil если значение метаданных не может быть представлено как дата.

    Оператор импорта

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в iOS 4.0 и позже.

  • Возвраты из данного массива массив элементов метаданных, соответствующих указанное ключевое или ключевое пространство.

    Объявление

    Swift

    class func metadataItemsFromArray(_ array: [AnyObject]!, withKey key: AnyObject!, keySpace keySpace: String!) -> [AnyObject]!

    Objective C

    + (NSArray *)metadataItemsFromArray:(NSArray *)array withKey:(id)key keySpace:(NSString *)keySpace

    Параметры

    array

    Массив AVMetadataItem объекты, которые будут отфильтрованы.

    key

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

    Если Вы не хотите фильтровать ключом, передачей nil.

    keySpace

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

    Если Вы не хотите фильтровать ключевым пространством, передачей nil.

    Возвращаемое значение

    Массив элементов метаданных от array то соответствие key или keySpace.

    Обсуждение

    Если значение в keySpace параметр AVMetadataKeySpaceCommon, значение элемента метаданных commonKey свойство должно соответствовать значение в key параметр для элемента, который будет возвращен. Если key параметр nil, тогда все элементы метаданных в общем ключевом пространстве возвращаются.

    Если значение в keySpace параметр nil или не константа для общего ключевого пространства, значения элемента метаданных key свойство должно соответствовать значение в key параметр для элемента, который будет возвращен. Если key сам параметр nil, тогда все элементы метаданных в указанном ключевом пространстве возвращаются.

    Оператор импорта

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в iOS 4.0 и позже.

  • Возвраты из данного массива массив элементов метаданных, соответствующих указанную локаль.

    Объявление

    Swift

    class func metadataItemsFromArray(_ array: [AnyObject]!, withLocale locale: NSLocale!) -> [AnyObject]!

    Objective C

    + (NSArray *)metadataItemsFromArray:(NSArray *)array withLocale:(NSLocale *)locale

    Параметры

    array

    Массив AVMetadataItem объекты, которые будут отфильтрованы.

    locale

    Локаль, которая должна быть соответствующей для элемента метаданных, который будет включен в выходной массив.

    Возвращаемое значение

    Массив, содержащий AVMetadataItem объекты от array параметр, которые соответствуют указанную локаль.

    Оператор импорта

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в iOS 4.0 и позже.

  • Возвращает подмножество элементов метаданных, локали которых соответствуют один из указанных идентификаторов языка.

    Объявление

    Swift

    class func metadataItemsFromArray(_ metadataItems: [AnyObject]!, filteredAndSortedAccordingToPreferredLanguages preferredLanguages: [AnyObject]!) -> [AnyObject]!

    Objective C

    + (NSArray *)metadataItemsFromArray:(NSArray *)metadataItems filteredAndSortedAccordingToPreferredLanguages:(NSArray *)preferredLanguages

    Параметры

    metadataItems

    Массив AVMetadataItem объекты, которые будут отфильтрованы и сортированы.

    preferredLanguages

    Массив NSString объекты, каждый из которых содержит канонический идентификатор IETF BCP 47 языка. Порядок идентификаторов в массиве отражает предпочтительный порядок языка с самым предпочтительным языком, находящимся первым в массиве. Как правило, Вы передаете предпочтительные языки пользователя путем получения этого массива от preferredLanguages метод класса NSLocale.

    Возвращаемое значение

    Массив, содержащий AVMetadataItem объекты от metadataItems параметр, которые соответствуют один из указанных языков.

    Оператор импорта

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в iOS 6.0 и позже.

  • Фильтрует массив элементов метаданных с помощью фильтра элемента метаданных.

    Объявление

    Swift

    class func metadataItemsFromArray(_ metadataItems: [AnyObject]!, filteredByMetadataItemFilter metadataItemFilter: AVMetadataItemFilter!) -> [AnyObject]!

    Objective C

    + (NSArray *)metadataItemsFromArray:(NSArray *)metadataItems filteredByMetadataItemFilter:(AVMetadataItemFilter *)metadataItemFilter

    Параметры

    metadataItems

    Массив AVMetadataItems быть отфильтрованным.

    metadataItemFilter

    AVMetadataItemFilter объект для фильтрации metadataItems.

    Возвращаемое значение

    Экземпляр NSArray содержа элементы метаданных в metadataItems это не было удалено metadataItemFilter.

    Оператор импорта

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в iOS 7.0 и позже.

    См. также

    metadataItemFilterForSharing (AVMetadataItemFilter)

  • Фильтрует массив элементов метаданных согласно идентификатору.

    Объявление

    Swift

    class func metadataItemsFromArray(_ metadataItems: [AnyObject]!, filteredByIdentifier identifier: String!) -> [AnyObject]!

    Objective C

    + (NSArray *)metadataItemsFromArray:(NSArray *)metadataItems filteredByIdentifier:(NSString *)identifier

    Параметры

    metadataItems

    Массив элементов метаданных.

    identifier

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

    Возвращаемое значение

    Массив, содержащий элементы метаданных, соответствующие указанный идентификатор.

    Оператор импорта

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в iOS 8.0 и позже.