Ссылка MusicTrack

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

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

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

Функции

Конфигурирование музыкальных треков


    
    MusicTrackGetSequence (_: _:)
    MusicTrackGetSequence

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

Объявление

Swift

func MusicTrackGetSequence(_ inTrack: MusicTrack, _ outSequence: UnsafeMutablePointer<MusicSequence>) -> OSStatus

Objective C

OSStatus MusicTrackGetSequence ( MusicTrack inTrack, MusicSequence *outSequence );

Параметры

`inTrack`	Музыкальный трек, для которого Вы хотите знать музыкальную последовательность.
`outSequence`	По возврату, музыкальная последовательность, из которой музыкальный трек является элементом.

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

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

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

Objective C

@import AudioToolbox;

Swift

import AudioToolbox

Доступность

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


    
    MusicTrackSetDestNode (_: _:)
    MusicTrackSetDestNode

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

Объявление

Swift

func MusicTrackSetDestNode(_ inTrack: MusicTrack, _ inNode: AUNode) -> OSStatus

Objective C

OSStatus MusicTrackSetDestNode ( MusicTrack inTrack, AUNode inNode );

Параметры

`inTrack`	Музыкальный трек, для которого Вы хотите установить целевой узел аудиоустройства.
`inNode`	Узел, что Вы указывающий как цель для музыкального трека.

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

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

Обсуждение

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

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

Objective C

@import AudioToolbox;

Swift

import AudioToolbox

Доступность

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


    
    MusicTrackSetDestMIDIEndpoint (_: _:)
    MusicTrackSetDestMIDIEndpoint

Ставит цель события музыкального трека к конечной точке MIDI.

Объявление

Swift

func MusicTrackSetDestMIDIEndpoint(_ inTrack: MusicTrack, _ inEndpoint: MIDIEndpointRef) -> OSStatus

Objective C

OSStatus MusicTrackSetDestMIDIEndpoint ( MusicTrack inTrack, MIDIEndpointRef inEndpoint );

Параметры

`inTrack`	Музыкальный трек, для которого Вы хотите установить целевую конечную точку MIDI.
`inEndpoint`	Конечная точка MIDI, что Вы указывающий как цель для музыкального трека.

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

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

Обсуждение

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

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

Objective C

@import AudioToolbox;

Swift

import AudioToolbox

Доступность

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


    
    MusicTrackGetDestNode (_: _:)
    MusicTrackGetDestNode

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

Объявление

Swift

func MusicTrackGetDestNode(_ inTrack: MusicTrack, _ outNode: UnsafeMutablePointer<AUNode>) -> OSStatus

Objective C

OSStatus MusicTrackGetDestNode ( MusicTrack inTrack, AUNode *outNode );

Параметры

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

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

Код результата. Если цель события музыкального трека является конечной точкой MIDI, возвратами kAudioToolboxErr_IllegalTrackDestination.

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

Objective C

@import AudioToolbox;

Swift

import AudioToolbox

Доступность

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


    
    MusicTrackGetDestMIDIEndpoint (_: _:)
    MusicTrackGetDestMIDIEndpoint

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

Объявление

Swift

func MusicTrackGetDestMIDIEndpoint(_ inTrack: MusicTrack, _ outEndpoint: UnsafeMutablePointer<MIDIEndpointRef>) -> OSStatus

Objective C

OSStatus MusicTrackGetDestMIDIEndpoint ( MusicTrack inTrack, MIDIEndpointRef *outEndpoint );

Параметры

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

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

Код результата. Если цель события музыкального трека является узлом аудиоустройства, возвратами kAudioToolboxErr_IllegalTrackDestination.

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

Objective C

@import AudioToolbox;

Swift

import AudioToolbox

Доступность

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


    
    MusicTrackSetProperty (_: _: _: _:)
    MusicTrackSetProperty

Устанавливает значение свойства музыкального трека.

Объявление

Swift

func MusicTrackSetProperty(_ inTrack: MusicTrack, _ inPropertyID: UInt32, _ inData: UnsafeMutablePointer<Void>, _ inLength: UInt32) -> OSStatus

Objective C

OSStatus MusicTrackSetProperty ( MusicTrack inTrack, UInt32 inPropertyID, void *inData, UInt32 inLength );

Параметры

`inTrack`	Музыкальный трек, для которого Вы хотите установить значение свойства.
`inPropertyID`	Идентификатор для свойства музыкального трека, которое Вы хотите установить. Посмотрите Свойства Музыкального трека для возможных значений.
`inData`	Новое значение свойства.
`inLength`	Размер нового значения свойства.

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

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

Обсуждение

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

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

Objective C

@import AudioToolbox;

Swift

import AudioToolbox

Доступность

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


    
    MusicTrackGetProperty (_: _: _: _:)
    MusicTrackGetProperty

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

Объявление

Swift

func MusicTrackGetProperty(_ inTrack: MusicTrack, _ inPropertyID: UInt32, _ outData: UnsafeMutablePointer<Void>, _ ioLength: UnsafeMutablePointer<UInt32>) -> OSStatus

Objective C

OSStatus MusicTrackGetProperty ( MusicTrack inTrack, UInt32 inPropertyID, void *outData, UInt32 *ioLength );

Параметры

`inTrack`	Музыкальный трек, от которого Вы хотите получить значение свойства.
`inPropertyID`	Идентификатор для свойства музыкального трека, которое Вы хотите получить. Посмотрите Свойства Музыкального трека для возможных значений.
`outData`	На выводе, требуемом значении свойства.
`ioLength`	На вводе, доступном размере для полученного значения свойства. На выводе, размере допустимых данных свойства это `outData` точки к.

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

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

Обсуждение

К значениям свойств музыкального трека всегда получает доступ ссылка. С OS X v10.6, все такие значения свойств являются фиксированной длиной.

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

Для получения размера значения свойства вызовите эту функцию с outData набор параметра к NULL. На выводе, ioLength параметр содержит размер свойства.

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

Objective C

@import AudioToolbox;

Swift

import AudioToolbox

Доступность

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

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


    
    MusicTrackNewMIDINoteEvent (_: _: _:)
    MusicTrackNewMIDINoteEvent

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

Объявление

Swift

func MusicTrackNewMIDINoteEvent(_ inTrack: MusicTrack, _ inTimeStamp: MusicTimeStamp, _ inMessage: UnsafePointer<MIDINoteMessage>) -> OSStatus

Objective C

OSStatus MusicTrackNewMIDINoteEvent ( MusicTrack inTrack, MusicTimeStamp inTimeStamp, const MIDINoteMessage *inMessage );

Параметры

`inTrack`	Музыкальный трек для добавления события к.
`inTimeStamp`	Метка времени, в ударах, в которых можно добавить событие. Должно быть больше, чем или равным 0.
`inMessage`	Событие для добавления к музыкальному треку.

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

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

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

Objective C

@import AudioToolbox;

Swift

import AudioToolbox

Доступность

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


    
    MusicTrackNewMIDIChannelEvent (_: _: _:)
    MusicTrackNewMIDIChannelEvent

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

Объявление

Swift

func MusicTrackNewMIDIChannelEvent(_ inTrack: MusicTrack, _ inTimeStamp: MusicTimeStamp, _ inMessage: UnsafePointer<MIDIChannelMessage>) -> OSStatus

Objective C

OSStatus MusicTrackNewMIDIChannelEvent ( MusicTrack inTrack, MusicTimeStamp inTimeStamp, const MIDIChannelMessage *inMessage );

Параметры

`inTrack`	Музыкальный трек для добавления события к.
`inTimeStamp`	Метка времени, в ударах, в которых можно добавить событие. Должно быть больше, чем или равным 0.
`inMessage`	Событие для добавления к музыкальному треку.

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

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

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

Objective C

@import AudioToolbox;

Swift

import AudioToolbox

Доступность

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


    
    MusicTrackNewMIDIRawDataEvent (_: _: _:)
    MusicTrackNewMIDIRawDataEvent

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

Объявление

Swift

func MusicTrackNewMIDIRawDataEvent(_ inTrack: MusicTrack, _ inTimeStamp: MusicTimeStamp, _ inMessage: UnsafePointer<MIDIRawData>) -> OSStatus

Objective C

OSStatus MusicTrackNewMIDIRawDataEvent ( MusicTrack inTrack, MusicTimeStamp inTimeStamp, const MIDIRawData *inRawData );

Параметры

`inTrack`	Музыкальный трек для добавления события к.
`inTimeStamp`	Метка времени, в ударах, в которых можно добавить событие. Должно быть больше, чем или равным 0.
`inMessage`	Событие для добавления к музыкальному треку.

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

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

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

Objective C

@import AudioToolbox;

Swift

import AudioToolbox

Доступность

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


    
    MusicTrackNewExtendedNoteEvent (_: _: _:)
    MusicTrackNewExtendedNoteEvent

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

Объявление

Swift

func MusicTrackNewExtendedNoteEvent(_ inTrack: MusicTrack, _ inTimeStamp: MusicTimeStamp, _ inMessage: UnsafePointer<ExtendedNoteOnEvent>) -> OSStatus

Objective C

OSStatus MusicTrackNewExtendedNoteEvent ( MusicTrack inTrack, MusicTimeStamp inTimeStamp, const ExtendedNoteOnEvent *inInfo );

Параметры

`inTrack`	Музыкальный трек для добавления события к.
`inTimeStamp`	Метка времени, в ударах, в которых можно добавить событие. Должно быть больше, чем или равным 0.
`inMessage`	Событие для добавления к музыкальному треку.

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

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

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

Objective C

@import AudioToolbox;

Swift

import AudioToolbox

Доступность

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


    
    MusicTrackNewExtendedControlEvent
    MusicTrackNewExtendedControlEvent

(OS X v10.7)

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

Объявление

Objective C

OSStatus MusicTrackNewExtendedControlEvent ( MusicTrack inTrack, MusicTimeStamp inTimeStamp, const ExtendedControlEvent *inInfo );

Параметры

`inTrack`	Музыкальный трек для добавления события к.
`inTimeStamp`	Метка времени, в ударах, в которых можно добавить событие. Должно быть больше, чем или равным 0.
`inMessage`	Событие для добавления к музыкальному треку.

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

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

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

Objective C

@import AudioToolbox;

Доступность

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

Осуждаемый в OS X v10.7.


    
    MusicTrackNewParameterEvent (_: _: _:)
    MusicTrackNewParameterEvent

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

Объявление

Swift

func MusicTrackNewParameterEvent(_ inTrack: MusicTrack, _ inTimeStamp: MusicTimeStamp, _ inMessage: UnsafePointer<ParameterEvent>) -> OSStatus

Objective C

OSStatus MusicTrackNewParameterEvent ( MusicTrack inTrack, MusicTimeStamp inTimeStamp, const ParameterEvent *inInfo );

Параметры

`inTrack`	Музыкальный трек для добавления события к.
`inTimeStamp`	Метка времени, в ударах, в которых можно добавить событие. Должно быть больше, чем или равным 0.
`inMessage`	Событие для добавления к музыкальному треку.

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

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

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

Objective C

@import AudioToolbox;

Swift

import AudioToolbox

Доступность

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


    
    MusicTrackNewExtendedTempoEvent (_: _: _:)
    MusicTrackNewExtendedTempoEvent

Добавляет в прежнем темпе к музыкальному треку.

Объявление

Swift

func MusicTrackNewExtendedTempoEvent(_ inTrack: MusicTrack, _ inTimeStamp: MusicTimeStamp, _ inBPM: Float64) -> OSStatus

Objective C

OSStatus MusicTrackNewExtendedTempoEvent ( MusicTrack inTrack, MusicTimeStamp inTimeStamp, Float64 inBPM );

Параметры

`inTrack`	Музыкальный трек для добавления события к.
`inTimeStamp`	Метка времени, в ударах, в которых можно добавить событие. Должно быть больше, чем или равным 0.
`inBPM`	Темп, в ударах в минуту, для добавления к музыкальному треку.

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

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

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

Objective C

@import AudioToolbox;

Swift

import AudioToolbox

Доступность

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


    
    MusicTrackNewMetaEvent (_: _: _:)
    MusicTrackNewMetaEvent

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

Объявление

Swift

func MusicTrackNewMetaEvent(_ inTrack: MusicTrack, _ inTimeStamp: MusicTimeStamp, _ inMessage: UnsafePointer<MIDIMetaEvent>) -> OSStatus

Objective C

OSStatus MusicTrackNewMetaEvent ( MusicTrack inTrack, MusicTimeStamp inTimeStamp, const MIDIMetaEvent *inMetaEvent );

Параметры

`inTrack`	Музыкальный трек для добавления события к.
`inTimeStamp`	Метка времени, в ударах, в которых можно добавить событие. Должно быть больше, чем или равным 0.
`inMessage`	Событие для добавления к музыкальному треку.

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

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

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

Objective C

@import AudioToolbox;

Swift

import AudioToolbox

Доступность

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


    
    MusicTrackNewUserEvent (_: _: _:)
    MusicTrackNewUserEvent

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

Объявление

Swift

func MusicTrackNewUserEvent(_ inTrack: MusicTrack, _ inTimeStamp: MusicTimeStamp, _ inMessage: UnsafePointer<MusicEventUserData>) -> OSStatus

Objective C

OSStatus MusicTrackNewUserEvent ( MusicTrack inTrack, MusicTimeStamp inTimeStamp, const MusicEventUserData *inUserData );

Параметры

`inTrack`	Музыкальный трек для добавления события к.
`inTimeStamp`	Метка времени, в ударах, в которых можно добавить событие. Должно быть больше, чем или равным 0.
`inMessage`	Событие для добавления к музыкальному треку.

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

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

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

Objective C

@import AudioToolbox;

Swift

import AudioToolbox

Доступность

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


    
    MusicTrackNewAUPresetEvent (_: _: _:)
    MusicTrackNewAUPresetEvent

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

Объявление

Swift

func MusicTrackNewAUPresetEvent(_ inTrack: MusicTrack, _ inTimeStamp: MusicTimeStamp, _ inMessage: UnsafePointer<AUPresetEvent>) -> OSStatus

Objective C

OSStatus MusicTrackNewAUPresetEvent ( MusicTrack inTrack, MusicTimeStamp inTimeStamp, const AUPresetEvent *inPresetEvent );

Параметры

`inTrack`	Музыкальный трек для добавления события к.
`inTimeStamp`	Метка времени, в ударах, в которых можно добавить событие. Должно быть больше, чем или равным 0.
`inMessage`	Событие для добавления к музыкальному треку.

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

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

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

Objective C

@import AudioToolbox;

Swift

import AudioToolbox

Доступность

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

Редактирование музыкальных треков


    
    MusicTrackMoveEvents (_: _: _: _:)
    MusicTrackMoveEvents

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

Объявление

Swift

func MusicTrackMoveEvents(_ inTrack: MusicTrack, _ inStartTime: MusicTimeStamp, _ inEndTime: MusicTimeStamp, _ inMoveTime: MusicTimeStamp) -> OSStatus

Objective C

OSStatus MusicTrackMoveEvents ( MusicTrack inTrack, MusicTimeStamp inStartTime, MusicTimeStamp inEndTime, MusicTimeStamp inMoveTime );

Параметры

`inTrack`	Дорожка, события которой Вы хотите продвинуться или назад своевременно.
`inStartTime`	Текущее время начала, в ударах, для событий музыкального трека Вы хотите переместиться.
`inEndTime`	Текущее время окончания, в ударах, для событий музыкального трека Вы хотите переместиться.
`inMoveTime`	Число ударов для перемещения указанного диапазона событий музыкального трека. Положительное значение перемещает события к концу музыкального трека; отрицательная величина перемещает события к запуску.

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

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

Обсуждение

inStartTime значение должно быть меньше, чем inEndTime значение.

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

Objective C

@import AudioToolbox;

Swift

import AudioToolbox

Доступность

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


    
    MusicTrackClear (_: _: _:)
    MusicTrackClear

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

Объявление

Swift

func MusicTrackClear(_ inTrack: MusicTrack, _ inStartTime: MusicTimeStamp, _ inEndTime: MusicTimeStamp) -> OSStatus

Objective C

OSStatus MusicTrackClear ( MusicTrack inTrack, MusicTimeStamp inStartTime, MusicTimeStamp inEndTime );

Параметры

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

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

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

Обсуждение

inStartTime значение должно быть меньше, чем inEndTime значение.

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

Objective C

@import AudioToolbox;

Swift

import AudioToolbox

Доступность

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


    
    MusicTrackCut (_: _: _:)
    MusicTrackCut

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

Объявление

Swift

func MusicTrackCut(_ inTrack: MusicTrack, _ inStartTime: MusicTimeStamp, _ inEndTime: MusicTimeStamp) -> OSStatus

Objective C

OSStatus MusicTrackCut ( MusicTrack inTrack, MusicTimeStamp inStartTime, MusicTimeStamp inEndTime );

Параметры

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

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

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

Обсуждение

inStartTime значение должно быть меньше, чем inEndTime значение.

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

Objective C

@import AudioToolbox;

Swift

import AudioToolbox

Доступность

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


    
    MusicTrackCopyInsert (_: _: _: _: _:)
    MusicTrackCopyInsert

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

Объявление

Swift

func MusicTrackCopyInsert(_ inSourceTrack: MusicTrack, _ inSourceStartTime: MusicTimeStamp, _ inSourceEndTime: MusicTimeStamp, _ inDestTrack: MusicTrack, _ inDestInsertTime: MusicTimeStamp) -> OSStatus

Objective C

OSStatus MusicTrackCopyInsert ( MusicTrack inSourceTrack, MusicTimeStamp inSourceStartTime, MusicTimeStamp inSourceEndTime, MusicTrack inDestTrack, MusicTimeStamp inDestInsertTime );

Параметры

`inSourceTrack`	Музыкальный трек, с которого Вы хотите скопировать события.
`inSourceStartTime`	Время начала, в ударах, для диапазона событий музыкального трека, которые Вы хотите скопировать с исходной дорожки.
`inSourceEndTime`	Время окончания, в ударах, для диапазона событий музыкального трека, которые Вы хотите скопировать с исходной дорожки.
`inDestTrack`	Музыкальный трек, к которому Вы хотите добавить события.
`inDestInsertTime`	Точка вставки, в ударах, в целевом музыкальном треке для скопированных событий.

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

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

Обсуждение

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

inSourceStartTime значение должно быть меньше, чем inSourceEndTime значение.

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

Objective C

@import AudioToolbox;

Swift

import AudioToolbox

Доступность

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


    
    MusicTrackMerge (_: _: _: _: _:)
    MusicTrackMerge

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

Объявление

Swift

func MusicTrackMerge(_ inSourceTrack: MusicTrack, _ inSourceStartTime: MusicTimeStamp, _ inSourceEndTime: MusicTimeStamp, _ inDestTrack: MusicTrack, _ inDestInsertTime: MusicTimeStamp) -> OSStatus

Objective C

OSStatus MusicTrackMerge ( MusicTrack inSourceTrack, MusicTimeStamp inSourceStartTime, MusicTimeStamp inSourceEndTime, MusicTrack inDestTrack, MusicTimeStamp inDestInsertTime );

Параметры

`inSourceTrack`	Музыкальный трек, с которого Вы хотите скопировать события.
`inSourceStartTime`	Время начала, в ударах, для диапазона событий музыкального трека, которые Вы хотите скопировать с исходной дорожки.
`inSourceEndTime`	Время окончания, в ударах, для диапазона событий музыкального трека, которые Вы хотите скопировать с исходной дорожки.
`inDestTrack`	Музыкальный трек, к которому Вы хотите добавить события.
`inDestInsertTime`	Точка вставки, в ударах, в целевом музыкальном треке для скопированных событий.

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

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

Обсуждение

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

inSourceStartTime значение должно быть меньше, чем inSourceEndTime значение.

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

Objective C

@import AudioToolbox;

Swift

import AudioToolbox

Доступность

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

Типы данных

MusicTrack

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

Объявление

Swift

typealias MusicTrack = COpaquePointer

Objective C

typedef struct OpaqueMusicTrack *MusicTrack;

Обсуждение

Музыкальный трек (типа MusicTrack) имеет свойства, которые могут быть проверены и присвоены, включая поддержку цикличного выполнения, muting/soloing, и интерпретацию метки времени. Вы можете выполнить итерации через события в музыкальном треке и можете выполнить различные операции редактирования на них.

Музыкальный трек является компонентом музыкальной последовательности (типа MusicSequence), который поочередно играется аудиоплеером (типа MusicPlayer).

Доступность

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


      
      MusicTrackLoopInfo

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

Объявление

Swift

struct MusicTrackLoopInfo { var loopDuration: MusicTimeStamp var numberOfLoops: Int32 }

Objective C

typedef struct MusicTrackLoopInfo { MusicTimeStamp loopDuration; SInt32 numberOfLoops; } MusicTrackLoopInfo;

Поля


      loopDuration

Точка в музыкальном треке, измеренном в ударах от конца музыкального трека, в котором можно начать воспроизведение во время циклично выполненного воспроизведения. Т.е. во время циклично выполненного воспроизведения музыкальный трек играет от (kSequenceTrackProperty_TrackLength – loopDuration) к kSequenceTrackProperty_TrackLength.

Для цикличного выполнения навсегда установить numberOfLoops к 0. Для явного выключения цикличного выполнения укажите a loopDuration из 0.


      numberOfLoops

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

Обсуждение

Этот тип данных используется для значения kSequenceTrackProperty_LoopInfo свойство.

Доступность

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


      
      MIDINoteMessage

Описывает примечание MIDI.

Объявление

Swift

struct MIDINoteMessage { var channel: UInt8 var note: UInt8 var velocity: UInt8 var releaseVelocity: UInt8 var duration: Float32 }

Objective C

typedef struct MIDINoteMessage { UInt8 channel; UInt8 note; UInt8 velocity; UInt8 releaseVelocity; Float32 duration; } MIDINoteMessage;

Поля

`channel`	MIDI образовывает канал для игры примечания по.
`note`	Примечание для игры.
`velocity`	Скорость нажатия клавиши для примечания.
`releaseVelocity`	Скорость ключевого выпуска для примечания. Используйте 0, если Вы не хотите указывать определенное значение.
`duration`	Продолжительность для примечания.

Доступность

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


      
      MIDIChannelMessage

Описывает сообщение канала MIDI.

Объявление

Swift

struct MIDIChannelMessage { var status: UInt8 var data1: UInt8 var data2: UInt8 var reserved: UInt8 }

Objective C

typedef struct MIDIChannelMessage { UInt8 status; UInt8 data1; UInt8 data2; UInt8 reserved; } MIDIChannelMessage;

Поля

`status`	Данные, определенные для сообщения канала.
`data1`
`data2`
`reserved`

Доступность

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

MIDIRawData

Описывает MIDI, монопольный системой (SysEx) сообщение.

Объявление

Swift

struct MIDIRawData { var length: UInt32 var data: (UInt8) }

Objective C

typedef struct MIDIRawData { UInt32 length; UInt8 data[1]; } MIDIRawData;

Поля

length

data

Доступность

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


      
      MIDIMetaEvent

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

Объявление

Swift

struct MIDIMetaEvent { var metaEventType: UInt8 var unused1: UInt8 var unused2: UInt8 var unused3: UInt8 var dataLength: UInt32 var data: (UInt8) }

Objective C

typedef struct MIDIMetaEvent { UInt8 metaEventType; UInt8 unused1; UInt8 unused2; UInt8 unused3; UInt32 dataLength; UInt8 data[1]; } MIDIMetaEvent;

Поля

`metaEventType`	Целое число, определяющее один из типов метасобытий MIDI.
`unused1`
`unused2`
`unused3`
`dataLength`
`data`

Доступность

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


      
      MusicEventUserData

Описывает определяемое пользователем событие.

Объявление

Swift

struct MusicEventUserData { var length: UInt32 var data: (UInt8) }

Objective C

typedef struct MusicEventUserData { UInt32 length; UInt8 data[1]; } MusicEventUserData;

Поля

`length`	Размер, в байтах, пользовательских данных.
`data`	Определяемые пользователем данные.

Доступность

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


      
      ExtendedNoteOnEvent

Описывает примечание - на событии с расширенными параметрами.

Объявление

Swift

struct ExtendedNoteOnEvent { var instrumentID: MusicDeviceInstrumentID var groupID: MusicDeviceGroupID var duration: Float32 var extendedParams: MusicDeviceNoteParams }

Objective C

typedef struct ExtendedNoteOnEvent { MusicDeviceInstrumentID instrumentID; MusicDeviceGroupID groupID; Float32 duration; MusicDeviceNoteParams extendedParams; } ExtendedNoteOnEvent;

Поля

`instrumentID`
`groupID`
`duration`
`extendedParams`

Доступность

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

ExtendedControlEvent

Описывает событие автоматизации параметра аудиоустройства, специализированное для Модулей инструментов.

Объявление

Swift

struct ExtendedControlEvent { var groupID: MusicDeviceGroupID var controlID: AudioUnitParameterID var value: AudioUnitParameterValue }

Objective C

typedef struct ExtendedControlEvent { MusicDeviceGroupID groupID; AudioUnitParameterID controlID; AudioUnitParameterValue value; } ExtendedControlEvent;

Поля

groupID

controlID

value

Доступность

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


      
      ParameterEvent

Описывает событие автоматизации параметра аудиоустройства.

Объявление

Swift

struct ParameterEvent { var parameterID: AudioUnitParameterID var scope: AudioUnitScope var element: AudioUnitElement var value: AudioUnitParameterValue }

Objective C

typedef struct ParameterEvent { AudioUnitParameterID parameterID; AudioUnitScope scope; AudioUnitElement element; AudioUnitParameterValue value; } ParameterEvent;

Поля

`parameterID`
`scope`
`element`
`value`

Доступность

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

ExtendedTempoEvent

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

Объявление

Swift

struct ExtendedTempoEvent { var bpm: Float64 }

Objective C

typedef struct ExtendedTempoEvent { Float64 bpm; } ExtendedTempoEvent;

Поля

bpm

Число ударов в минуту.

Доступность

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

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

Объявление

Swift

struct AUPresetEvent { var scope: AudioUnitScope var element: AudioUnitElement var preset: Unmanaged<CFPropertyList>! }

Objective C

typedef struct AUPresetEvent { AudioUnitScope scope; AudioUnitElement element; CFPropertyListRef preset; } AUPresetEvent;

Поля

scope

element

preset

Доступность

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

Константы

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

Объявление

Swift

var kSequenceTrackProperty_LoopInfo: Int { get } var kSequenceTrackProperty_OffsetTime: Int { get } var kSequenceTrackProperty_MuteStatus: Int { get } var kSequenceTrackProperty_SoloStatus: Int { get } var kSequenceTrackProperty_AutomatedParameters: Int { get } var kSequenceTrackProperty_TrackLength: Int { get } var kSequenceTrackProperty_TimeResolution: Int { get }

Objective C

enum { kSequenceTrackProperty_LoopInfo = 0, kSequenceTrackProperty_OffsetTime = 1, kSequenceTrackProperty_MuteStatus = 2, kSequenceTrackProperty_SoloStatus = 3, kSequenceTrackProperty_AutomatedParameters = 4, kSequenceTrackProperty_TrackLength = 5, kSequenceTrackProperty_TimeResolution = 6 };

Константы
- kSequenceTrackProperty_LoopInfo
  
  kSequenceTrackProperty_LoopInfo
  
  Поведение цикличного выполнения для музыкального трека. Цикличное выполнение прочь по умолчанию; по умолчанию музыкальный трек играет точно один раз. Чтение-запись Music Track Loop Information структура.
  
  Доступный в OS X v10.0 и позже.
- kSequenceTrackProperty_OffsetTime
  
  kSequenceTrackProperty_OffsetTime
  
  Время начала музыкального трека с точки зрения числа удара. По умолчанию это значение 0. Чтение-запись MusicTimeStamp значение.
  
  Доступный в OS X v10.0 и позже.
- kSequenceTrackProperty_MuteStatus
  
  kSequenceTrackProperty_MuteStatus
  
  Бесшумное/небесшумное состояние музыкального трека. По умолчанию это значение false (не отключенный звук). Булево значение чтения-записи.
  
  Доступный в OS X v10.0 и позже.
- kSequenceTrackProperty_SoloStatus
  
  kSequenceTrackProperty_SoloStatus
  
  Состояние соло/несоло музыкального трека. По умолчанию это значение false (не soloed). Булево значение чтения-записи.
  
  Доступный в OS X v10.0 и позже.
- kSequenceTrackProperty_AutomatedParameters
  
  kSequenceTrackProperty_AutomatedParameters
  
  Указывает, является ли цель музыкального трека автоматизацией параметра аудиоустройства. Если значение этого свойства отличается 0, музыкальные события в дорожке могут только указать точки в кривой автоматизации. Чтение-запись UInt32 значение, где значение кроме 0 указывает, что дорожка для автоматизации параметра.
  
  Доступный в OS X v10.2 и позже.
- kSequenceTrackProperty_TrackLength
  
  kSequenceTrackProperty_TrackLength
  
  Время последнего музыкального события в музыкальном треке, плюс время, требуемое для примечания, постепенно исчезает и т.д.
  
  Если это свойство не установлено, длина музыкального трека равняется концу последнего активного события в дорожке и корректируется динамично, поскольку события добавлены или удалены. Значение этого свойства является указанной длиной дорожки или расчетной длиной — какой бы ни больше. Чтение-запись MusicTimeStamp значение.
  
  Доступный в OS X v10.3 и позже.
- kSequenceTrackProperty_TimeResolution
  
  kSequenceTrackProperty_TimeResolution
  Разрешение времени для последовательности музыкальных событий. Например, это значение может указать разрешение времени, указанное файлом MIDI, используемым для построения последовательности.
  
  Для использования определенного разрешения времени при записи нового файла получите это значение и затем укажите его при вызове MusicSequenceFileCreate функция.
  
  Это значение непосредственно не определяет скорость воспроизведения для музыкального трека, а скорее этого
  
  kSequenceTrackProperty_TimeResolution установлен двумя возможными способами:
  
  При создании музыкальной последовательности программно значение установлено в 480.
  
  При создании музыкальной последовательности из файла MIDI значение установлено в разрешение времени, указанное в файле MIDI.
  
  Только для чтения SInt16 значение, которое допустимо только для в прежнем темпе дорожки.
  Доступный в OS X v10.5 и позже.