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

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

Разработчик

Ссылка DRBurn.h

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

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

Ссылка DRBurn.h

Выполните и контролируйте запись диска DVD или CD.

Каждый раз, когда Вы хотите гореть к диску, экземпляр DRBurn должен быть создан.

Когда экземпляр создается, Вы передаете в экземпляре DRDevice для уведомления объекта DRBurn что устройство использовать. Этот объект сохраняется для жизни экземпляра DRBurn. Перед записью можно установить несколько опций, управляющих поведением записи и обработкой диска, как только завершается запись.

Объект DRBurn отошлет уведомления через механизм DRNotificationCenter для широковещательной передачи состояния записи любым заинтересованным наблюдателям. Однако, если по некоторым причинам Вы не хотите использовать уведомления, можно опросить объект записи в любое время относительно состояния использования текущего статуса. Это не рекомендуется ни в каком приложении с помощью цикла выполнения, потому что оно включает опрос.

Для примеров того, как использовать этот класс, см. дисковые проекты примера кода в/Developer/Examples/DiscRecording/ObjectiveC/.

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

  • <Foundation/Foundation.h>

  • <DiscRecording/DRCoreBurn.h>

  • <DiscRecording/DRDevice.h>

  • <DiscRecording/DRTrack.h>

  • <AvailabilityMacros.h>

Константы

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

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

    Объявление

    Swift

    let DRBurnAppendableKey: NSString! let DRBurnCompletionActionEject: NSString! let DRBurnCompletionActionKey: NSString! let DRBurnCompletionActionMount: NSString! let DRBurnDoubleLayerL0DataZoneBlocksKey: NSString! let DRBurnFailureActionEject: NSString! let DRBurnFailureActionKey: NSString! let DRBurnFailureActionNone: NSString! let DRBurnOverwriteDiscKey: NSString! let DRBurnRequestedSpeedKey: NSString! let DRBurnStatusChangedNotification: NSString! let DRBurnStrategyBDDAO: NSString! let DRBurnStrategyCDSAO: NSString! let DRBurnStrategyCDTAO: NSString! let DRBurnStrategyDVDDAO: NSString! let DRBurnStrategyIsRequiredKey: NSString! let DRBurnStrategyKey: NSString! let DRBurnTestingKey: NSString! let DRBurnUnderrunProtectionKey: NSString! let DRBurnVerifyDiscKey: NSString! let DRCDTextKey: NSString! let DRMediaCatalogNumberKey: NSString! let DRSynchronousBehaviorKey: NSString!

    Objective C

    extern NSString* const DRBurnAppendableKey; extern NSString* const DRBurnCompletionActionEject; extern NSString* const DRBurnCompletionActionKey; extern NSString* const DRBurnCompletionActionMount; extern NSString* const DRBurnDoubleLayerL0DataZoneBlocksKey; extern NSString* const DRBurnFailureActionEject; extern NSString* const DRBurnFailureActionKey; extern NSString* const DRBurnFailureActionNone; extern NSString* const DRBurnOverwriteDiscKey; extern NSString* const DRBurnRequestedSpeedKey; extern NSString* const DRBurnStatusChangedNotification; extern NSString* const DRBurnStrategyBDDAO; extern NSString* const DRBurnStrategyCDSAO; extern NSString* const DRBurnStrategyCDTAO; extern NSString* const DRBurnStrategyDVDDAO; extern NSString* const DRBurnStrategyIsRequiredKey; extern NSString* const DRBurnStrategyKey; extern NSString* const DRBurnTestingKey; extern NSString* const DRBurnUnderrunProtectionKey; extern NSString* const DRBurnVerifyDiscKey; extern NSString* const DRCDTextKey; extern NSString* const DRMediaCatalogNumberKey; extern NSString* const DRSynchronousBehaviorKey;

    Константы

    • DRBurnAppendableKey

      DRBurnAppendableKey

      Свойство записи, значение которого является BOOL указание, если диск все еще будет appendable после записи. Если этот ключ не будет присутствовать, то запись примет значение по умолчанию к значению НЕ, и диск будет отмечен как не appendable.

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

    • DRBurnCompletionActionEject

      DRBurnCompletionActionEject

      NSString оценивает за DRBurnCompletionActionKey, указывающий, что объект записи должен извлечь диск от диска, когда завершается запись.

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

    • DRBurnCompletionActionKey

      DRBurnCompletionActionKey

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

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

    • DRBurnCompletionActionMount

      DRBurnCompletionActionMount

      NSString оценивает за DRBurnCompletionActionKey, указывающий, что объект записи должен смонтировать диск на рабочем столе, когда завершается запись.

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

    • DRBurnDoubleLayerL0DataZoneBlocksKey

      DRBurnDoubleLayerL0DataZoneBlocksKey

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

      Размер зоны данных уровня 0 диктует, где точка перехода от уровня 0 до уровня 1. Если этот ключ будет присутствовать, то размер зоны данных будет установлен до запуска записи с помощью значения для этого ключа. Если это не будет присутствовать, то зона данных уровня 0 по умолчанию будет использоваться (половина доступных блоков на пустом диске).

      Точка перехода может быть указана два пути. Если значение, указанное в этом ключе, будет больше, чем 1,0, то это будет определять абсолютный номер блока для точки перехода. В этом случае номер блока должен быть кратным числом 16 и по крайней мере 40000-й на спецификацию. Если значение будет меньше чем 1,0, то оно укажет процент записи, которая должна находиться на уровне 0. Типичное значение 0.5, определяя половину записи для каждого уровня. Значение 0,0 или 1.0 не изменит точку перехода уровня 0.

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

    • DRBurnFailureActionEject

      DRBurnFailureActionEject

      NSString оценивает за DRBurnFailureActionKey, указывающий, что объект записи должен извлечь диск от диска, если запись перестала работать.

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

    • DRBurnFailureActionKey

      DRBurnFailureActionKey

      Свойство записи, значение которого является NSString, содержащим то из действий отказа, возможных для обработки содержимого диска.

      Если этот ключ не будет присутствовать, то запись примет значение по умолчанию к значению DRBurnFailureActionEject, и диск будет извлечен.

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

    • DRBurnFailureActionNone

      DRBurnFailureActionNone

      NSString оценивает за DRBurnFailureActionKey, указывающий, что объект записи ничего не должен делать с диском, если запись перестала работать.

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

    • DRBurnOverwriteDiscKey

      DRBurnOverwriteDiscKey

      Свойство записи, значение которого является BOOL указание, если диск будет перезаписан от блочного нуля для записи. Если этот ключ не будет присутствовать, то запись примет значение по умолчанию к значению НЕ, и диск будет добавлен.

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

    • DRBurnRequestedSpeedKey

      DRBurnRequestedSpeedKey

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

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

    • DRBurnStatusChangedNotification

      DRBurnStatusChangedNotification

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

      Объект, связанный с этим уведомлением, является объектом DRBurn, отправка его и userInfo содержат тот же словарь, как возвращено состоянием, детализирующим текущее состояние записи.

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

    • DRBurnStrategyBDDAO

      DRBurnStrategyBDDAO

      NSString оценивает за DRBurnStrategyKey, представляющий DAO (диск сразу) стратегия записи BD (Blu-ray). Эта стратегия применяется только к BDs.

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

    • DRBurnStrategyCDSAO

      DRBurnStrategyCDSAO

      NSString оценивает за DRBurnStrategyKey, представляющий SAO (сеанс сразу) стратегия записи CD.

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

    • DRBurnStrategyCDTAO

      DRBurnStrategyCDTAO

      NSString оценивает за DRBurnStrategyKey, представляющий TAO (дорожка сразу) стратегия записи CD.

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

    • DRBurnStrategyDVDDAO

      DRBurnStrategyDVDDAO

      NSString оценивает за DRBurnStrategyKey, представляющий DAO (диск сразу) стратегия записи DVD. Эта стратегия применяется только к DVDs; это недопустимо при записи к носителям CD.

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

    • DRBurnStrategyIsRequiredKey

      DRBurnStrategyIsRequiredKey

      Свойство записи, значение которого является BOOL указание, является ли стратегия/стратегии записи, перечисленная для DRBurnStrategyKey, единственными позволенными стратегиями. Если этот ключ не будет присутствовать, то запись примет значение по умолчанию к значению НЕТ.

      Если это значение будет установлено в ДА, и устройство не поддерживает тип (ы) записи, которую требуют, то запись перестанет работать с kDRDeviceBurnStrategyNotAvailableErr.

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

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

    • DRBurnStrategyKey

      DRBurnStrategyKey

      Свойство записи, значение которого является NSString или массивом Нсстрингса, указывая предлагающиеся стратегию записи или стратегии. Если этот ключ не присутствует, механизм записи выбирает надлежащую стратегию записи автоматически. Большинство клиентов не должно будет указывать определенную стратегию записи.

      Когда больше чем одна стратегия будет предложена, механизм записи попытается использовать первую стратегию в списке, который доступен. Стратегия записи никогда не будет использоваться, если она не может записать требуемые данные: например, TAO не может использоваться для записи текста CD.

      Присутствие этого ключа отдельно является просто предложением, и если механизм записи не может выполнить запрос, это запишет использование независимо от того, что стратегия доступна. Для выдвижения предположения в требование добавьте DRBurnStrategyIsRequiredKey со значением YES.

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

    • DRBurnTestingKey

      DRBurnTestingKey

      Свойство записи, значение которого является BOOL указание, если запись будет работать как тестовая запись.

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

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

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

    • DRBurnUnderrunProtectionKey

      DRBurnUnderrunProtectionKey

      Свойство записи, значение которого является BOOL указание, если защита недогрузки записи будет идти или прочь для устройств, поддерживающих его.

      Для тех устройств, поддерживающих его, защита недогрузки записи включена по умолчанию.

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

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

    • DRBurnVerifyDiscKey

      DRBurnVerifyDiscKey

      Свойство записи, значение которого является BOOL указание, если диск будет проверен, будучи записанным. Если этот ключ не будет присутствовать, то запись примет значение по умолчанию к значению YES, и диск будет проверен.

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

    • DRCDTextKey

      DRCDTextKey

      Это ключевые пункты к DRCDTextBlock или массив DRCDTextBlocks, содержащего информацию о тексте CD для диска. Если этот ключ не будет присутствовать, то запись не запишет текст CD.

      Перед использованием этого ключа Вы должны, чтобы удостовериться, что устройство поддерживает текст CD путем проверки значения DRDeviceCanWriteCDTextKey в словаре возможностей записи устройства.

      Если это значение будет установлено в ДА, и устройство не поддерживает текст CD записи, то запись перестанет работать с kDRDeviceCantWriteCDTextErr.

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

    • DRMediaCatalogNumberKey

      DRMediaCatalogNumberKey

      Свойство записи, значение которого является NSData, содержащим точно 13 байтов данных, которые будут записаны в диск как Число Каталога Носителей. Если этот ключ не будет присутствовать, то он примет значение по умолчанию ко всем, обнуляет, указывая, что не предоставляется MCN.

      Это значение является номером продуктов UPC/EAN и должно соответствовать спецификациям UCC и EAN. Посмотрите http://www .ean-int.org/и http://www .uc-council.org/для большего количества подробных данных о стандарте UPC/EAN.

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

    • DRSynchronousBehaviorKey

      DRSynchronousBehaviorKey

      Свойство записи, значение которого является BOOL указание, если операции записи будут вести себя синхронно. Если этот ключ не будет присутствовать, то он будет принимать значение по умолчанию к значению НЕ и гореть, операции будут вести себя асинхронно.

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

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