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

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

Разработчик

Ссылка DRCDText.h

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

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

Ссылка DRCDText.h

Текстовый объект CD используется в DiscRecording APIs.

Текст CD является системой, позволяющей авторам аудиокомпакт-диска кодировать текстовую информацию о CD и его дорожках на диск. Информация, такая как название альбома, имена дорожки, художник, автор песен, исполнитель, и больше может быть закодировано этот путь. Когда диск, содержащий текст CD, вставляется в текст CD осведомленный проигрыватель, эта информация выведена на экран как игры CD.

Текст CD только для аудиокомпакт-дисков; это не применяется к и не работает над данными CDs или DVDs.

Вот концептуальное описание того, как работает текст CD. Информация о тексте CD для диска может содержать до восьми блоков текстовой информации. Каждый блок имеет связанный кодовый набор языка и набор символов, и содержит полный набор информации о диске.

  • +----------------------------+
  • | +------------------------+ |
  • | | CD-Text block 1 | |
  • | | - language code | |
  • | | - character set | |
  • | +------------------------+ |
  • | . |
  • | . |
  • | . |
  • | +------------------------+ |
  • | | CD-Text block 8 | |
  • | | - language code | |
  • | | - character set | |
  • | +------------------------+ |
  • +----------------------------+

Обычно каждый блок текста CD будет использоваться для содержания различного языка (английский, французский, японский язык, китайский язык, и т.д.). Однако это возможно и допустимо иметь многократные блоки, что каждый содержит тот же язык.

Каждый блок кодирует полный набор информации о диске и его дорожках. Эта информация хранится как массив словарей значения ключа; один на дорожку, с дополнительным словарем для самого диска/альбома (представленный индексом массива 0). На диске с дорожками n будут n+1 словари.

  • +----------------------------+
  • | CD-Text block |
  • | - language code |
  • | - character set |
  • | +------------------------+ |
  • | | Index 0 - disc info | |
  • | +------------------------+ |
  • | +------------------------+ |
  • | | Index 1 - track 1 info | |
  • | +------------------------+ |
  • | +------------------------+ |
  • | | Index 2 - track 2 info | |
  • | +------------------------+ |
  • | . |
  • | . |
  • | . |
  • | +------------------------+ |
  • | | Index n - track n info | |
  • | +------------------------+ |
  • +----------------------------+

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

  • +----------------------------+
  • | Track info dictionary |
  • | |
  • | Title = "title" |
  • | Artist = "artist" |
  • | Performer = "performer" |
  • | . |
  • | . |
  • | . |
  • +----------------------------+

Для лучшей совместимости с проигрывателями компакт-дисков отдельные текстовые элементы в словарях должны составить 160 байтов или меньший. Так как кодировки в настоящее время поддерживаемого символа являются всеми однобайтовыми кодировками, это означает максимум 160 символов на запись.

Включенные заголовки

  • <Foundation/Foundation.h>

  • <CoreServices/CoreServices.h>

  • <DiscRecording/DRCoreCDText.h>

  • <AvailabilityMacros.h>

Константы

Посмотрите раздел Overview выше для документации уровня заголовка.

  • Глобальные константы

    Объявление

    Swift

    let DRCDTextArrangerKey: NSString! let DRCDTextCharacterCodeKey: NSString! let DRCDTextClosedKey: NSString! let DRCDTextComposerKey: NSString! let DRCDTextCopyrightAssertedForNamesKey: NSString! let DRCDTextCopyrightAssertedForSpecialMessagesKey: NSString! let DRCDTextCopyrightAssertedForTitlesKey: NSString! let DRCDTextDiscIdentKey: NSString! let DRCDTextGenreCodeKey: NSString! let DRCDTextGenreKey: NSString! let DRCDTextLanguageKey: NSString! let DRCDTextMCNISRCKey: NSString! let DRCDTextNSStringEncodingKey: NSString! let DRCDTextPerformerKey: NSString! let DRCDTextSizeKey: NSString! let DRCDTextSongwriterKey: NSString! let DRCDTextSpecialMessageKey: NSString! let DRCDTextTitleKey: NSString! let DRCDTextTOC2Key: NSString! let DRCDTextTOCKey: NSString!

    Objective C

    extern NSString* const DRCDTextArrangerKey; extern NSString* const DRCDTextCharacterCodeKey; extern NSString* const DRCDTextClosedKey; extern NSString* const DRCDTextComposerKey; extern NSString* const DRCDTextCopyrightAssertedForNamesKey; extern NSString* const DRCDTextCopyrightAssertedForSpecialMessagesKey; extern NSString* const DRCDTextCopyrightAssertedForTitlesKey; extern NSString* const DRCDTextDiscIdentKey; extern NSString* const DRCDTextGenreCodeKey; extern NSString* const DRCDTextGenreKey; extern NSString* const DRCDTextLanguageKey; extern NSString* const DRCDTextMCNISRCKey; extern NSString* const DRCDTextNSStringEncodingKey; extern NSString* const DRCDTextPerformerKey; extern NSString* const DRCDTextSizeKey; extern NSString* const DRCDTextSongwriterKey; extern NSString* const DRCDTextSpecialMessageKey; extern NSString* const DRCDTextTitleKey; extern NSString* const DRCDTextTOC2Key; extern NSString* const DRCDTextTOCKey;

    Константы

    • DRCDTextArrangerKey

      DRCDTextArrangerKey

      Один из ключей для словарей дорожки в Текстовом блоке CD. Значение для этого ключа является NSString, содержа аранжировщика дорожки/диска.

      Доступный в OS X v10.4 и позже.

    • DRCDTextCharacterCodeKey

      DRCDTextCharacterCodeKey

      Требуемый ключ свойства для Текстового блока CD. Значение для этого свойства является NSNumber, содержа значение набора символов Красной книги для текста блока. Это значение не является CFStringEncoding или NSStringEncoding, и не должно использоваться как таковое.

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

      Доступный в OS X v10.4 и позже.

    • DRCDTextClosedKey

      DRCDTextClosedKey

      Один из ключей для словарей дорожки в Текстовом блоке CD. Значение для этого ключа является NSString, содержа данные о диске. Формат этих данных произволен и до контент-провайдера. Эта информация является частной, и проигрыватели не должны отображать ее пользователю диска.

      Доступный в OS X v10.4 и позже.

    • DRCDTextComposerKey

      DRCDTextComposerKey

      Один из ключей для словарей дорожки в Текстовом блоке CD. Значение для этого ключа является NSString, содержа композитора дорожки/диска.

      Доступный в OS X v10.4 и позже.

    • DRCDTextCopyrightAssertedForNamesKey

      DRCDTextCopyrightAssertedForNamesKey

      Дополнительный ключ свойства для Текстового блока CD. Значение для этого свойства является NSNumber, содержа значение BOOL, указывающее, утверждается ли авторское право на именах в блоке. (DRCDTextPerformerKey, DRCDTextSongwriterKey, DRCDTextComposerKey, DRCDTextArrangerKey)

      Если это значение не указано, никакое авторское право не утверждается для этих элементов.

      Доступный в OS X v10.4 и позже.

    • DRCDTextCopyrightAssertedForSpecialMessagesKey

      DRCDTextCopyrightAssertedForSpecialMessagesKey

      Дополнительный ключ свойства для Текстового блока CD. Значение для этого свойства является NSNumber, содержа значение BOOL, указывающее, утверждается ли авторское право на сообщениях в блоке (DRCDTextSpecialMessageKey).

      Если это значение не указано, никакое авторское право не утверждается для этих элементов.

      Доступный в OS X v10.4 и позже.

    • DRCDTextCopyrightAssertedForTitlesKey

      DRCDTextCopyrightAssertedForTitlesKey

      Дополнительный ключ свойства для Текстового блока CD. Значение для этого свойства является NSNumber, содержа значение BOOL, указывающее, утверждается ли авторское право на заголовках диска и дорожек. (DRCDTextTitleKey)

      Если это значение не указано, никакое авторское право не утверждается для этих элементов.

      Доступный в OS X v10.4 и позже.

    • DRCDTextDiscIdentKey

      DRCDTextDiscIdentKey

      Один из ключей для словарей дорожки в Текстовом блоке CD. Значение для этого ключа является NSString, содержа диск информация о ID, такая как число каталога и имя звукозаписывающей компании, кода торговой точки, год продаж, и т.д. Каждый элемент должен быть разделен наклонной чертой (» / «).

      Этот ключ только допустим для диска (индекс массива 0) и проигнорирован, когда установлено в словарях для дорожек.

      Доступный в OS X v10.4 и позже.

    • DRCDTextGenreCodeKey

      DRCDTextGenreCodeKey

      Один из ключей для словарей дорожки в Текстовом блоке CD. Значение для этого ключа является NSNumber, содержа числовой код для жанра диска, как перечислено выше.

      Этот ключ только допустим для диска (индекс массива 0) и проигнорирован, когда установлено в словарях для дорожек.

      Доступный в OS X v10.4 и позже.

    • DRCDTextGenreKey

      DRCDTextGenreKey

      Один из ключей для словарей дорожки в Текстовом блоке CD. Значение для этого ключа является NSString, содержа описание жанра диска.

      Этот ключ только допустим для диска (индекс массива 0) и проигнорирован, когда установлено в словарях для дорожек.

      Доступный в OS X v10.4 и позже.

    • DRCDTextLanguageKey

      DRCDTextLanguageKey

      Требуемый ключ свойства для Текстового блока CD. Значение для этого свойства является NSNumber, содержа числовой код для языка. Это значение является значением кода языка Красной книги для текста блока.

      Язык может быть изменен после того, как блок создается.

      Доступный в OS X v10.4 и позже.

    • DRCDTextMCNISRCKey

      DRCDTextMCNISRCKey

      Один из ключей для словарей дорожки в Текстовом блоке CD. Значение для этого ключа является NSData, содержа любые 13 байтов MCN (для диска) или 12 байтов ISRC (для дорожек).

      Эта информация может также быть указана в свойствах дорожки и записи. Текст CD просто обеспечивает альтернативу, возможно избыточный способ закодировать эту информацию. Если бы MCN или ISRC были указаны в свойствах для записи или дорожки, то это значение должно быть тем же. Дополнительную информацию см. в описаниях DRMediaCatalogNumberKey и DRTrackISRCKey на точном формате данных.

      Доступный в OS X v10.4 и позже.

    • DRCDTextNSStringEncodingKey

      DRCDTextNSStringEncodingKey

      Требуемый ключ свойства для Текстового блока CD. Значение для этого свойства является NSNumber, содержа NSStringEncoding для текста блока.

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

      Доступный в OS X v10.4 и позже.

    • DRCDTextPerformerKey

      DRCDTextPerformerKey

      Один из ключей для словарей дорожки в Текстовом блоке CD. Значение для этого ключа является NSString, содержа исполнителя дорожки/диска.

      Доступный в OS X v10.4 и позже.

    • DRCDTextSizeKey

      DRCDTextSizeKey

      Один из ключей для словарей дорожки в Текстовом блоке CD. Значение для этого ключа является NSData, содержа информацию о числе пакетов и языков, связанных с каждым блоком.

      Этот ключ предоставлен в выходных целях только при чтении текста CD из существующего диска. Это проигнорировано, когда указано в записи.

      Доступный в OS X v10.4 и позже.

    • DRCDTextSongwriterKey

      DRCDTextSongwriterKey

      Один из ключей для словарей дорожки в Текстовом блоке CD. Значение для этого ключа является NSString, содержа автора песен дорожки/диска.

      Доступный в OS X v10.4 и позже.

    • DRCDTextSpecialMessageKey

      DRCDTextSpecialMessageKey

      Один из ключей для словарей дорожки в Текстовом блоке CD. Значение для этого ключа является NSString, содержа текстовое сообщение, которое может быть выведено на экран пользователю некоторыми проигрывателями.

      Доступный в OS X v10.4 и позже.

    • DRCDTextTitleKey

      DRCDTextTitleKey

      Один из ключей для словарей дорожки в Текстовом блоке CD. Значение для этого ключа является NSString, содержа заголовок дорожки/диска.

      Доступный в OS X v10.4 и позже.

    • DRCDTextTOC2Key

      DRCDTextTOC2Key

      Один из ключей для словарей дорожки в Текстовом блоке CD. Значение для этого ключа является NSData, содержа дополнительную информацию об оглавлении.

      Этот ключ предоставлен в выходных целях только при чтении текста CD из существующего диска. Это проигнорировано, когда указано в записи.

      Доступный в OS X v10.4 и позже.

    • DRCDTextTOCKey

      DRCDTextTOCKey

      Один из ключей для словарей дорожки в Текстовом блоке CD. Значение для этого ключа является NSData, содержа информацию об оглавлении.

      Этот ключ предоставлен в выходных целях только при чтении текста CD из существующего диска. Это проигнорировано, когда указано в записи.

      Доступный в OS X v10.4 и позже.