Присвоение значений к атрибутам метаданных
Центр внимания определяет стандартные атрибуты метаданных, обеспечивающие широкий диапазон опций для хранения метаданных файла Вашего приложения. Для пользователей, чтобы быть в состоянии найти данные легко, важно, чтобы Вы использовали стандартные атрибуты метаданных, когда это возможно.
Атрибуты метаданных центра внимания
Центр внимания обеспечивает стандартные атрибуты метаданных для следующего:
Атрибуты файловой системы. Например, размер файла, владелец и дата модификации. Они извлечены из файловой системы автоматически Центром внимания.
Связанные с изображением атрибуты. Например, биты на выборку, цветовое пространство, пиксельную высоту и ширину.
Связанные с видео атрибуты. Например, кодек, видео скорость передачи и скорость передачи звука.
Связанные с аудио атрибуты. Например, частота дискретизации, номер дорожки, композитор и музыкальный размер.
Приписывает характерный для многих приложений. Например, авторы, город, организация, адреса электронной почты и заголовок.
Стандартные атрибуты метаданных документируются в Ссылку Атрибутов Метаданных Файла.
В дополнение к зависящим от контекста атрибутам Центр внимания обеспечивает общий текстовый атрибут (kMDItemTextContent
) то, что средства импорта могут заполнить с текстовым представлением содержания файла. Приложения могут создать запросы, которые ссылаются на этот атрибут, но не в состоянии считать значение этого атрибута непосредственно.
Если бы существующий ключ атрибута был бы надлежащим, необходимо избежать создавать собственные атрибуты метаданных. Например, если метаданные Вашего файла включают фотографа изображения, используйте kMDItemAuthors
атрибут вместо того, чтобы определить пользовательский атрибут фотографа. Или, если Ваш файл включает название компании, используйте kMDItemOrganizations
атрибут.
Посмотрите Присваивающиеся Значения к Атрибутам Метаданных для примера того, как присвоить значения атрибутам метаданных.
Локализация значений атрибута метаданных
Средство импорта Центра внимания может обеспечить локализованные значения для атрибута путем возврата объекта словаря вместо строкового значения. Словарь должен содержать ключи, соответствующие локализованным языкам. Например, «en» для английского языка, «франк» для французского языка, и т.д. Значение для каждого ключа должно быть соответствующим локализованным значением атрибута.
Определение пользовательских атрибутов
Если ни один из стандартных атрибутов Центра внимания не является надлежащим или адаптируемым к Вашим метаданным, можно определить пользовательский атрибут метаданных. Средство импорта указывает имя пользовательского атрибута, а также тип данных, которые это содержит в schema.xml
файл.
Припишите соглашения о присвоении имен
Пользовательские атрибуты метаданных должны иметь уникальные имена. Гарантировать имя - уникальное использование обратное соглашение о присвоении имен DNS как префикс для ключей, которые являются определенными для Ваших типов файлов, заменяющих «.» «_» символы. Например, Почтовая программа снабдила бы префиксом свои пользовательские атрибуты com_apple_mail
.
Определение типа объекта значения
Необходимо указать тип объекта, возвращающегося в пользовательском атрибуте. Поддерживаемые типы CFString
, CFNumber
, CFBoolean
, и CFDate
.
Возврат многократных значений в атрибуте
Если Ваши пользовательские атрибуты могут содержать многократные объекты, объявить их как мультизначение в файле схемы Вашего средства импорта и всегда возвращать массив, даже если это содержит только единственный экземпляр.
Имена дисплея атрибута и описания
Средства импорта центра внимания, объявляющие пользовательские атрибуты метаданных, должны также обеспечить имя дисплея и описание для каждого атрибута. Эти строки содержатся в файле schema.strings
в пакете средства импорта Центра внимания.
Файл должен быть текстом UTF-16, закодированным отформатированный, поскольку стандарт представляет файл в виде строки. Ключи имени дисплея соответствуют пользовательскому имени атрибута метаданных. Строка описания указана путем добавления “.Description
” к ключевому имени. Перечисление 1 показывает выборку schema.strings файл.
schema.strings файл средства импорта Выборки перечисления 1
"com_apple_myCocoaDocumentApp_myCustomDocument_notes" = "Notes"; |
"com_apple_myCocoaDocumentApp_myCustomDocument_notes.Description" = "What it is you're supposed to remember."; |
Можно локализовать schema.strings
файлы с помощью стандартных соглашений.