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

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

Разработчик

Ссылка платформы AudioToolbox ссылка MusicSequence

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

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

Ссылка MusicSequence

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

Непрозрачные типы, используемые с музыкальной последовательностью, описаны в следующих документах:

Коды результата для этого непрозрачного типа описаны в Ссылке MusicPlayer.

Функции

Создание и конфигурирование музыкальных последовательностей
  • NewMusicSequence (_:) NewMusicSequence

    Создает новую пустую музыкальную последовательность.

    Объявление

    Swift

    func NewMusicSequence(_ outSequence: UnsafeMutablePointer<MusicSequence>) -> OSStatus

    Objective C

    OSStatus NewMusicSequence ( MusicSequence *outSequence );

    Параметры

    outSequence

    На выводе, новой, пустой музыкальной последовательности.

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

    Код результата.

    Обсуждение

    Новая музыкальная последовательность имеет только в прежнем темпе дорожку с темпом по умолчанию 120 ударов в минуту. Тип последовательности по умолчанию основан на ударе. Для различных типов последовательности посмотрите Музыкальные Типы Последовательности.

    Для направления вывода музыкальной последовательности к графику обработки аудиоданных используйте MusicSequenceSetAUGraph функция. Для направления вывода вместо этого к конечной точке MIDI используйте MusicSequenceSetMIDIEndpoint функция.

    Для направления вывода определенного музыкального трека используйте MusicTrackSetDestNode и MusicTrackSetDestMIDIEndpoint функции, описанные в Ссылке MusicTrack.

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

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

    См. также

    DisposeMusicSequence

  • DisposeMusicSequence (_:) DisposeMusicSequence

    Избавляется от музыкальной последовательности.

    Объявление

    Swift

    func DisposeMusicSequence(_ inSequence: MusicSequence) -> OSStatus

    Objective C

    OSStatus DisposeMusicSequence ( MusicSequence inSequence );

    Параметры

    inSequence

    Музыкальная последовательность для избавления.

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

    Код результата.

    Обсуждение

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

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

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

    См. также

    NewMusicSequence

  • MusicSequenceSetSequenceType (_: _:) MusicSequenceSetSequenceType

    Устанавливает тип последовательности для музыкальной последовательности.

    Объявление

    Swift

    func MusicSequenceSetSequenceType(_ inSequence: MusicSequence, _ inType: MusicSequenceType) -> OSStatus

    Objective C

    OSStatus MusicSequenceSetSequenceType ( MusicSequence inSequence, MusicSequenceType inType );

    Параметры

    inSequence

    Музыкальная последовательность, тип последовательности которой Вы хотите установить.

    inType

    Тип последовательности для присвоения к музыкальной последовательности. Для списка доступных типов последовательности посмотрите Музыкальные Типы Последовательности. Тип последовательности по умолчанию kMusicSequenceType_Beats.

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

    Код результата.

    Обсуждение

    Тип последовательности может быть установлен в kMusicSequenceType_Beats в любое время. Тип последовательности может только быть установлен в kMusicSequenceType_Seconds или kMusicSequenceType_Samples при отсутствии событий темпа уже в последовательности.

    Следующие соображения принадлежат различным типам последовательности:

    • kMusicSequenceType_Beats— Темп указан как удары в минуту. Музыкальная последовательность этого типа может содержать любое число событий темпа.

    • kMusicSequenceType_Samples— Темп указан как частота дискретизации, с точки зрения выборок в секунду. Если Вы устанавливаете темп в 44 100 использований последовательности этого типа, то 44 100 ударов соответствуют продолжительности одной секунды.

    • kMusicSequenceType_Seconds— Темп должен быть установлен в 60; удар является секундой.

    После установки музыки упорядочивают к kMusicSequenceType_Samples или kMusicSequenceType_Seconds введите, добавьте единственное событие темпа для указания темпа.

    Представляющее интерес метасобытие для kMusicSequenceType_Seconds тип последовательности является метасобытием Смещения SMPTE, которое сохранено в треке управления темпом. Последовательность ничего не делает с этим событием.

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

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

    См. также

    MusicSequenceGetSequenceType

  • MusicSequenceGetSequenceType (_: _:) MusicSequenceGetSequenceType

    Получает тип последовательности для музыкальной последовательности.

    Объявление

    Swift

    func MusicSequenceGetSequenceType(_ inSequence: MusicSequence, _ outType: UnsafeMutablePointer<MusicSequenceType>) -> OSStatus

    Objective C

    OSStatus MusicSequenceGetSequenceType ( MusicSequence inSequence, MusicSequenceType *outType );

    Параметры

    inSequence

    Музыкальная последовательность, тип последовательности которой Вы хотите получить.

    outType

    На выводе, типе последовательности для музыкальной последовательности.

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

    Код результата.

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

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

    См. также

    MusicSequenceSetSequenceType

  • MusicSequenceSetSMPTEResolution MusicSequenceSetSMPTEResolution

    Вычисляет разрешение SMPTE для указанной частоты кадров и числа галочек на четвертную ноту.

    Объявление

    Objective C

    SInt16 MusicSequenceSetSMPTEResolution ( SignedByte fps, Byte ticks );

    Параметры

    fps

    Кадры в секунду.

    ticks

    Галочки на четвертную ноту.

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

    Разрешение SMPTE.

    См. также

    MusicSequenceFileCreate
    MusicSequenceGetSMPTEResolution

  • MusicSequenceGetSMPTEResolution MusicSequenceGetSMPTEResolution

    Вычисляет частоту кадров и число галочек на четвертную ноту для указанного разрешения SMPTE.

    Объявление

    Objective C

    MusicSequenceGetSMPTEResolution ( SInt16 inRes, SignedByte *fps, Byte *ticks );

    Параметры

    inRes

    Разрешение SMPTE файла MIDI.

    fps

    Кадры в секунду.

    ticks

    Галочки на четвертную ноту.

    См. также

    MusicSequenceFileCreate
    MusicSequenceSetSMPTEResolution

  • MusicSequenceSetUserCallback (_: _: _:) MusicSequenceSetUserCallback

    Регистрирует пользовательскую функцию обратного вызова в музыкальной последовательности.

    Объявление

    Swift

    func MusicSequenceSetUserCallback(_ inSequence: MusicSequence, _ inCallback: MusicSequenceUserCallback, _ inClientData: UnsafeMutablePointer<Void>) -> OSStatus

    Objective C

    OSStatus MusicSequenceSetUserCallback ( MusicSequence inSequence, MusicSequenceUserCallback inCallback, void *inClientData );

    Параметры

    inSequence

    Музыкальная последовательность, к которой Вы хотите добавить пользовательскую функцию обратного вызова.

    inCallback

    Ссылка на Вашу функцию обратного вызова. Использовать NULL удалить зарегистрированную функцию обратного вызова.

    inClientData

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

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

    Код результата.

    Обсуждение

    Музыкальная последовательность вызывает Ваш обратный вызов для каждого пользовательского события, добавленного к любому музыкальному треку, принадлежавшему последовательности. Если будет зарегистрированный обратный вызов, то UserEvents будет преследоваться, когда вызовут MusicPlayerSetTime. В этом случае inStartSliceBeat и inEndSliceBeat и будут тем же значением и будут ударом, к которому преследует проигрыватель.

    Обычно, где данные последовательности планируются для воспроизведения, следующее применяется:

    • inStartSliceBeat <= inEventTime < inEndSliceBeat

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

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

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

  • MusicSequenceGetInfoDictionary (_:) MusicSequenceGetInfoDictionary

    Возвращает словарь, содержащий музыкальную информацию о последовательности.

    Объявление

    Swift

    func MusicSequenceGetInfoDictionary(_ inSequence: MusicSequence) -> CFDictionary!

    Objective C

    CFDictionaryRef MusicSequenceGetInfoDictionary ( MusicSequence inSequence );

    Параметры

    inSequence

    Музыкальная последовательность, от которой Вы хотите информационный словарь.

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

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

    Обсуждение

    Словарь может содержать один или больше kAFInfoDictionary_* ключей, указанных в AudioToolbox/AudioFile.h. Вызывающая сторона должна выпустить возвращенный словарь. Если сбои вызова это возвратится NULL

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

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

Работа с музыкальными треками
  • MusicSequenceNewTrack (_: _:) MusicSequenceNewTrack

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

    Объявление

    Swift

    func MusicSequenceNewTrack(_ inSequence: MusicSequence, _ outTrack: UnsafeMutablePointer<MusicTrack>) -> OSStatus

    Objective C

    OSStatus MusicSequenceNewTrack ( MusicSequence inSequence, MusicTrack *outTrack );

    Параметры

    inSequence

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

    outTrack

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

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

    Код результата.

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

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

    См. также

    MusicSequenceDisposeTrack

  • MusicSequenceDisposeTrack (_: _:) MusicSequenceDisposeTrack

    Удаляет музыкальный трек из музыкальной последовательности и избавляется от дорожки.

    Объявление

    Swift

    func MusicSequenceDisposeTrack(_ inSequence: MusicSequence, _ inTrack: MusicTrack) -> OSStatus

    Objective C

    OSStatus MusicSequenceDisposeTrack ( MusicSequence inSequence, MusicTrack inTrack );

    Параметры

    inSequence

    Музыкальная последовательность для удаления музыкального трека из.

    inTrack

    Музыкальный трек, чтобы удалить и избавиться.

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

    Код результата.

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

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

    См. также

    MusicSequenceNewTrack

  • MusicSequenceGetTrackCount (_: _:) MusicSequenceGetTrackCount

    Получает число музыкальных треков, принадлежавших музыкальной последовательности.

    Объявление

    Swift

    func MusicSequenceGetTrackCount(_ inSequence: MusicSequence, _ outNumberOfTracks: UnsafeMutablePointer<UInt32>) -> OSStatus

    Objective C

    OSStatus MusicSequenceGetTrackCount ( MusicSequence inSequence, UInt32 *outNumberOfTracks );

    Параметры

    inSequence

    Музыкальная последовательность, количество дорожки которой Вы хотите.

    outNumberOfTracks

    На выводе, числе музыкальных треков в музыкальной последовательности.

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

    Код результата.

    Обсуждение

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

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

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

  • MusicSequenceGetIndTrack (_: _: _:) MusicSequenceGetIndTrack

    Получает музыкальный трек в указанном индексе дорожки.

    Объявление

    Swift

    func MusicSequenceGetIndTrack(_ inSequence: MusicSequence, _ inTrackIndex: UInt32, _ outTrack: UnsafeMutablePointer<MusicTrack>) -> OSStatus

    Objective C

    OSStatus MusicSequenceGetIndTrack ( MusicSequence inSequence, UInt32 inTrackIndex, MusicTrack *outTrack );

    Параметры

    inSequence

    Музыкальная последовательность для получения музыкального трека из.

    inTrackIndex

    Индекс целого числа для музыкального трека Вы хотите получить. Если значение для этого параметра не больше, чем 0 и меньше, чем число музыкальных треков, эта функция возвращает ошибку.

    outTrack

    На выводе, музыкальный трек, указанный inTrackIndex параметр.

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

    Код результата.

    Обсуждение

    Эта функция для доступа только к музыкальным трекам, не треку управления темпом.

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

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

    См. также

    MusicSequenceGetTrackIndex

  • MusicSequenceGetTrackIndex (_: _: _:) MusicSequenceGetTrackIndex

    Получает индекс для указанного музыкального трека.

    Объявление

    Swift

    func MusicSequenceGetTrackIndex(_ inSequence: MusicSequence, _ inTrack: MusicTrack, _ outTrackIndex: UnsafeMutablePointer<UInt32>) -> OSStatus

    Objective C

    OSStatus MusicSequenceGetTrackIndex ( MusicSequence inSequence, MusicTrack inTrack, UInt32 *outTrackIndex );

    Параметры

    inSequence

    Музыкальная последовательность для получения индекса дорожки из.

    inTrack

    Музыкальный трек, индекс которого Вы хотите получить. Если музыкальный трек не является частью музыкальной последовательности, указанной в, эта функция возвращает ошибку inSequence параметр.

    outTrackIndex

    На выводе, основанном на нуле индексе музыкального трека, который Вы обеспечили в inTrack параметр.

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

    Код результата.

    Обсуждение

    Эта функция для доступа, только индексирует для музыкальных треков, не трека управления темпом.

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

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

    См. также

    MusicSequenceGetIndTrack

  • MusicSequenceGetTempoTrack (_: _:) MusicSequenceGetTempoTrack

    Получает трек управления темпом для музыкальной последовательности.

    Объявление

    Swift

    func MusicSequenceGetTempoTrack(_ inSequence: MusicSequence, _ outTrack: UnsafeMutablePointer<MusicTrack>) -> OSStatus

    Objective C

    OSStatus MusicSequenceGetTempoTrack ( MusicSequence inSequence, MusicTrack *outTrack );

    Параметры

    inSequence

    Музыкальная последовательность, трек управления темпом которой Вы хотите получить.

    outTrack

    На выводе, треке управления темпом.

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

    Код результата.

    Обсуждение

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

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

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

Работа с графиками обработки аудиоданных и конечными точками MIDI
  • MusicSequenceSetAUGraph (_: _:) MusicSequenceSetAUGraph

    Связывает график обработки аудиоданных с музыкальной последовательностью.

    Объявление

    Swift

    func MusicSequenceSetAUGraph(_ inSequence: MusicSequence, _ inGraph: AUGraph) -> OSStatus

    Objective C

    OSStatus MusicSequenceSetAUGraph ( MusicSequence inSequence, AUGraph inGraph );

    Параметры

    inSequence

    Музыкальная последовательность для соединения с графиком обработки аудиоданных.

    inGraph

    График обработки аудиоданных для соединения с музыкальной последовательностью.

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

    Код результата.

    Обсуждение

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

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

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

    См. также

    MusicSequenceGetAUGraph

  • MusicSequenceGetAUGraph (_: _:) MusicSequenceGetAUGraph

    Связали график обработки аудиоданных с музыкальной последовательностью.

    Объявление

    Swift

    func MusicSequenceGetAUGraph(_ inSequence: MusicSequence, _ outGraph: UnsafeMutablePointer<AUGraph>) -> OSStatus

    Objective C

    OSStatus MusicSequenceGetAUGraph ( MusicSequence inSequence, AUGraph *outGraph );

    Параметры

    inSequence

    Музыкальная последовательность, связанный график обработки аудиоданных которой Вы хотите получить.

    outGraph

    На выводе график обработки аудиоданных связался с музыкальной последовательностью.

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

    Код результата.

    Обсуждение

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

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

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

    См. также

    MusicSequenceSetAUGraph

  • MusicSequenceSetMIDIEndpoint (_: _:) MusicSequenceSetMIDIEndpoint

    Связывает указанную конечную точку MIDI со всеми музыкальными треками в музыкальной последовательности.

    Объявление

    Swift

    func MusicSequenceSetMIDIEndpoint(_ inSequence: MusicSequence, _ inEndpoint: MIDIEndpointRef) -> OSStatus

    Objective C

    OSStatus MusicSequenceSetMIDIEndpoint ( MusicSequence inSequence, MIDIEndpointRef inEndpoint );

    Параметры

    inSequence

    Музыкальная последовательность, которую Вы хотите связать с конечной точкой MIDI.

    inEndpoint

    Конечная точка MIDI для соединения с музыкальной последовательностью.

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

    Код результата.

    Обсуждение

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

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

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

Работа со временем
  • MusicSequenceGetSecondsForBeats (_: _: _:) MusicSequenceGetSecondsForBeats

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

    Объявление

    Swift

    func MusicSequenceGetSecondsForBeats(_ inSequence: MusicSequence, _ inBeats: MusicTimeStamp, _ outSeconds: UnsafeMutablePointer<Float64>) -> OSStatus

    Objective C

    OSStatus MusicSequenceGetSecondsForBeats ( MusicSequence inSequence, MusicTimeStamp inBeats, Float64 *outSeconds );

    Параметры

    inSequence

    Последовательность, для которой Вы хотите получить количество секунд.

    inBeats

    Число ударов, для которых Вы хотите соответствующее число секунд.

    outSeconds

    На выводе, числе секунд, соответствующем числу ударов в inBeats параметр.

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

    Код результата.

    Обсуждение

    Эта функция использует музыкальный трек управления темпом последовательности.

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

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

    См. также

    MusicSequenceGetBeatsForSeconds

  • MusicSequenceGetBeatsForSeconds (_: _: _:) MusicSequenceGetBeatsForSeconds

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

    Объявление

    Swift

    func MusicSequenceGetBeatsForSeconds(_ inSequence: MusicSequence, _ inSeconds: Float64, _ outBeats: UnsafeMutablePointer<MusicTimeStamp>) -> OSStatus

    Objective C

    OSStatus MusicSequenceGetBeatsForSeconds ( MusicSequence inSequence, Float64 inSeconds, MusicTimeStamp *outBeats );

    Параметры

    inSequence

    Последовательность, для которой Вы хотите получить количество ударов.

    inSeconds

    Число секунд, для которых Вы хотите соответствующее число ударов.

    outBeats

    На выводе, числе ударов, соответствующем числу секунд в inSeconds параметр.

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

    Код результата.

    Обсуждение

    Эта функция использует музыкальный трек управления темпом последовательности.

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

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

    См. также

    MusicSequenceGetSecondsForBeats

  • MusicSequenceBeatsToBarBeatTime (_: _: _: _:) MusicSequenceBeatsToBarBeatTime

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

    Объявление

    Swift

    func MusicSequenceBeatsToBarBeatTime(_ inSequence: MusicSequence, _ inBeats: MusicTimeStamp, _ inSubbeatDivisor: UInt32, _ outBarBeatTime: UnsafeMutablePointer<CABarBeatTime>) -> OSStatus

    Objective C

    OSStatus MusicSequenceBeatsToBarBeatTime ( MusicSequence inSequence, MusicTimeStamp inBeats, UInt32 inSubbeatDivisor, CABarBeatTime *outBarBeatTime );

    Параметры

    inSequence

    Музыкальная последовательность, для которой Вы хотите отбивавший такт панелью.

    inBeats

    Удары, которые будут представлены как удары панели.

    inSubbeatDivisor

    Знаменатель дробного числа ударов.

    outBarBeatTime

    На выводе отбивала такт панелью музыкальная последовательность.

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

    Код результата.

    Обсуждение

    События музыкального размера трека управления темпом последовательности привыкли к вычислить представление удара панели. Если нет никаких событий Time Sig, добавленных к последовательности 4/4, принят. Событие музыкального размера является Метасобытием MIDI, как указано для файлов MIDI.

    Обратитесь к AudioToolbox/CAClock.h для получения дополнительной информации.

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

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

    См. также

    MusicSequenceBarBeatTimeToBeats

  • MusicSequenceBarBeatTimeToBeats (_: _: _:) MusicSequenceBarBeatTimeToBeats

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

    Объявление

    Swift

    func MusicSequenceBarBeatTimeToBeats(_ inSequence: MusicSequence, _ inBarBeatTime: UnsafePointer<CABarBeatTime>, _ outBeats: UnsafeMutablePointer<MusicTimeStamp>) -> OSStatus

    Objective C

    OSStatus MusicSequenceBarBeatTimeToBeats ( MusicSequence inSequence, const CABarBeatTime *inBarBeatTime, MusicTimeStamp *outBeats );

    Параметры

    inSequence

    Музыкальная последовательность, что Вы хотите счет удара.

    inBarBeatTime

    Отбивавший такт панелью, который будет представлен как удары.

    outBeats

    На выводе музыкальная последовательность имеет, отбивает такт.

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

    Код результата.

    Обсуждение

    События музыкального размера трека управления темпом последовательности привыкли к вычислить представление удара панели. Если нет никаких событий Time Sig, добавленных к последовательности 4/4, принят. Событие музыкального размера является Метасобытием MIDI, как указано для файлов MIDI.

    Обратитесь к AudioToolbox/CAClock.h для получения дополнительной информации.

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

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

    См. также

    MusicSequenceBeatsToBarBeatTime

  • MusicSequenceReverse (_:) MusicSequenceReverse

    Инвертирует MIDI и события темпа в музыкальной последовательности, таким образом, запуск становится концом.

    Объявление

    Swift

    func MusicSequenceReverse(_ inSequence: MusicSequence) -> OSStatus

    Objective C

    OSStatus MusicSequenceReverse ( MusicSequence inSequence );

    Параметры

    inSequence

    Музыкальная последовательность, которую Вы хотите к реверсу времени.

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

    Код результата.

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

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

Работа с файлами
  • MusicSequenceFileLoad (_: _: _: _:) MusicSequenceFileLoad

    Данные загрузок в музыку упорядочивают из ссылки URL.

    Объявление

    Swift

    func MusicSequenceFileLoad(_ inSequence: MusicSequence, _ inFileRef: CFURL!, _ inFileTypeHint: MusicSequenceFileTypeID, _ inFlags: MusicSequenceLoadFlags) -> OSStatus

    Objective C

    OSStatus MusicSequenceFileLoad ( MusicSequence inSequence, CFURLRef inFileRef, MusicSequenceFileTypeID inFileTypeHint, MusicSequenceLoadFlags inFlags );

    Параметры

    inSequence

    Музыкальная последовательность для загрузки данных в.

    inFileRef

    A file:// URL, указывающий на файл, содержащий данные для загрузки.

    inFileTypeHint

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

    inFlags

    Флаги, указывающие, как данные должны быть проанализированы, и как они должны быть присвоены дорожкам. Посмотрите Музыкальные Флаги Загрузки Последовательности.

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

    Код результата.

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

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

    См. также

    MusicSequenceFileLoadData

  • MusicSequenceFileLoadData (_: _: _: _:) MusicSequenceFileLoadData

    Данные загрузки в музыку упорядочивают от ссылки на данные.

    Объявление

    Swift

    func MusicSequenceFileLoadData(_ inSequence: MusicSequence, _ inData: CFData!, _ inFileTypeHint: MusicSequenceFileTypeID, _ inFlags: MusicSequenceLoadFlags) -> OSStatus

    Objective C

    OSStatus MusicSequenceFileLoadData ( MusicSequence inSequence, CFDataRef inData, MusicSequenceFileTypeID inFileTypeHint, MusicSequenceLoadFlags inFlags );

    Параметры

    inSequence

    Музыкальная последовательность для загрузки данных в.

    inData

    Содержание правильного файла загрузилось в a CFData объект.

    inFileTypeHint

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

    inFlags

    Флаги, указывающие, как данные должны быть проанализированы, и как они должны быть присвоены дорожкам. Посмотрите Музыкальные Флаги Загрузки Последовательности.

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

    Код результата.

    Обсуждение

    Данные, которые будут загружены, должны соответствовать типу файла, обозначенному inFileTypeHint параметр.

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

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

    См. также

    MusicSequenceFileLoad

  • MusicSequenceFileCreate (_: _: _: _: _:) MusicSequenceFileCreate

    Создает файл MIDI из событий в музыкальной последовательности.

    Объявление

    Swift

    func MusicSequenceFileCreate(_ inSequence: MusicSequence, _ inFileRef: CFURL!, _ inFileType: MusicSequenceFileTypeID, _ inFlags: MusicSequenceFileFlags, _ inResolution: Int16) -> OSStatus

    Objective C

    OSStatus MusicSequenceFileCreate ( MusicSequence inSequence, CFURLRef inFileRef, MusicSequenceFileTypeID inFileType, MusicSequenceFileFlags inFlags, SInt16 inResolution );

    Параметры

    inSequence

    Музыкальная последовательность, из которой Вы хотите создать файл MIDI.

    inFileRef

    URL к файлу MIDI, который будет создаваться.

    inFileType

    Тип файла для создания.

    inFlags

    Флаги, конфигурирующие процесс создания файла.

    inResolution

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

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

    Код результата.

    Обсуждение

    Эта функция может быть (и обычно), раньше создавал файл MIDI из событий в последовательности. Только MIDI базировался, события используются при создании файла MIDI. Файлы MIDI обычно являются базируемым ударом, но могут также иметь SMPTE (или в реальном времени, а не отбивать такт), представление.

    inResolution параметр указывает отношение между «галочкой» и четвертной нотой для сохранения к стандартному файлу MIDI. Передайте 0 этому параметру для использования значения по умолчанию; а именно, значение, в настоящее время устанавливающееся на треке управления темпом.

    Различные типы последовательности определяют виды файлов, которые могут быть созданы, следующим образом:

    • Удары — сохранив файл MIDI, это сохраняет, удары (PPQ) базировали ось.

    • Секунды — сохранив файл MIDI, это сохранит его как разрешение SMPTE - таким образом, необходимо будет указать это разрешение при создании файла MIDI. Если нуль указан, 25 кадр/с и 40 галочек/кадров используется (масштаб времени миллисекунды)

    • Выборки — Вы не можете сохранить к файлу MIDI с этим типом последовательности.

    Полное значение 16-разрядного поля «подразделения» в блоке MThd Файла MIDI. Если это положительно, то галочка представляет 1/D четвертные ноты. Если это отрицательный, принадлежит следующее:

    • Биты 14-8 являются 7-разрядным числом со знаком, представляющим формат SMPTE: 24,-25,-29 (отбрасывание),-30.

    • Биты 7-0 представляют число галочек на кадр SMPTE. Типичные значения равняются 4, 10, 80, 100. Можно получить разрешение миллисекунды путем указания 25 кадр/с и 40 подразделений/кадров:

      • 30 fps with 80 bits (ticks) per frame: 0xE250 ((char)0xE2 == -30)

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

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

    См. также

    MusicSequenceFileCreateData
    MusicSequenceSetSMPTEResolution

  • MusicSequenceFileCreateData (_: _: _: _: _:) MusicSequenceFileCreateData

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

    Объявление

    Swift

    func MusicSequenceFileCreateData(_ inSequence: MusicSequence, _ inFileType: MusicSequenceFileTypeID, _ inFlags: MusicSequenceFileFlags, _ inResolution: Int16, _ outData: UnsafeMutablePointer<Unmanaged<CFData>?>) -> OSStatus

    Objective C

    OSStatus MusicSequenceFileCreateData ( MusicSequence inSequence, MusicSequenceFileTypeID inFileType, MusicSequenceFileFlags inFlags, SInt16 inResolution, CFDataRef *outData );

    Параметры

    inSequence

    Музыкальная последовательность, из которой Вы хотите создать объект данных MIDI.

    inFileType

    Тип формата файла для данных в объекте данных.

    inFlags

    Флаги, конфигурирующие процесс создания объекта данных.

    inResolution

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

    outData

    На выводе, объект данных, содержащий данные MIDI в указанном формате.

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

    Код результата.

    Обсуждение

    CFData объект должен быть выпущен вызывающей стороной.

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

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

    См. также

    MusicSequenceFileCreate

Обратные вызовы

Обратные вызовы

Типы данных

  • MusicSequence

    Музыкальная последовательность.

    Объявление

    Swift

    typealias MusicSequence = COpaquePointer

    Objective C

    typedef struct OpaqueMusicSequence *MusicSequence;

    Доступность

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

  • MusicTimeStamp MusicTimeStamp

    Метка времени для использования музыкальной последовательностью.

    Объявление

    Swift

    typealias MusicTimeStamp = Float64

    Objective C

    typedef Float64 MusicTimeStamp;

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

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

Константы

  • Музыкальные флаги загрузки последовательности

    Флаги раньше конфигурировали поведение MusicSequenceFileLoad и MusicSequenceFileLoadData функции.

    Объявление

    Swift

    typealias MusicSequenceLoadFlags = UInt32

    Objective C

    enum { kMusicSequenceLoadSMF_ChannelsToTracks = (1 << 0) }; typedef UInt32 MusicSequenceLoadFlags;

    Константы

    • kMusicSequenceLoadSMF_ChannelsToTracks

      kMusicSequenceLoadSMF_ChannelsToTracks

      Если этот флаг будет установлен, то результирующая Последовательность будет содержать в прежнем темпе дорожку, 1 дорожку для каждого Канала MIDI, найденного в SMF, 1 дорожке для SysEx или MetaEvents - и это будет последней дорожкой в последовательности после вызовов LoadSMFWithFlags.

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

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

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

  • Музыкальные типы последовательности

    Различные типы музыкальных последовательностей.

    Объявление

    Swift

    typealias MusicSequenceType = UInt32

    Objective C

    enum { kMusicSequenceType_Beats = 'beat', kMusicSequenceType_Seconds = 'secs', kMusicSequenceType_Samples = 'samp' }; typedef UInt32 MusicSequenceType;

    Константы

    • kMusicSequenceType_Beats

      kMusicSequenceType_Beats

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

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

    • kMusicSequenceType_Seconds

      kMusicSequenceType_Seconds

      Используемый для музыкальной последовательности, соответствующей файлу MIDI, но использующей временной код SMPTE. Трек управления темпом содержит единственное событие темпа, указывающее 60 ударов в минуту.

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

    • kMusicSequenceType_Samples

      kMusicSequenceType_Samples

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

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

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

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

  • Музыкальные идентификаторы типа файла последовательности

    Различные типы файлов, которые могут быть проанализированы музыкальной последовательностью.

    Объявление

    Swift

    typealias MusicSequenceFileTypeID = UInt32

    Objective C

    enum { kMusicSequenceFile_MIDIType = 'midi', kMusicSequenceFile_iMelodyType = 'imel' }; typedef UInt32 MusicSequenceFileTypeID;

    Константы

    • kMusicSequenceFile_MIDIType

      kMusicSequenceFile_MIDIType

      Тип файла MIDI

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

    • kMusicSequenceFile_iMelodyType

      kMusicSequenceFile_iMelodyType

      iMelody тип файла.

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

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

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

  • Музыкальные флаги файла последовательности

    Флаги, конфигурирующие поведение MusicSequenceFileCreate и MusicSequenceFileCreateData функции.

    Объявление

    Swift

    typealias MusicSequenceFileFlags = UInt32

    Objective C

    enum { kMusicSequenceFileFlags_EraseFile = 1 }; typedef UInt32 MusicSequenceFileFlags;

    Константы

    • kMusicSequenceFileFlags_EraseFile

      kMusicSequenceFileFlags_EraseFile

      Указывает, что существующий файл должен быть стерт при создании нового файла.

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

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

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