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

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

Разработчик

Ссылка платформы AVFoundation ссылка класса AVAudioUnitMIDIInstrument

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

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

AVAudioUnitMIDIInstrument

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

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

Наследование

Соответствует

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

Swift

import AVFoundation

Objective C

@import AVFoundation;

Доступность

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

Создание инструментального аудиоустройства MIDI
  • init (audioComponentDescription:) - initWithAudioComponentDescription:

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

    Объявление

    Swift

    init!(audioComponentDescription description: AudioComponentDescription)

    Objective C

    - (instancetype)initWithAudioComponentDescription:(AudioComponentDescription)description

    Параметры

    description

    AudioComponentDescription структура. Компонент типа должен быть kAudioUnitType_MusicDevice или kAudioUnitType_RemoteInstrument.

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

    Инициализированный AVAudioUnitMIDIInstrument экземпляр с указанным AudioComponentDescription структура.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

Отправка информации к инструменту MIDI
  • sendController (_: withValue:onChannel:) - sendController:withValue:onChannel:

    Отправьте событие «контроллера» MIDI в инструмент.

    Объявление

    Swift

    func sendController(_ controller: UInt8, withValue value: UInt8, onChannel channel: UInt8)

    Objective C

    - (void)sendController:(uint8_t)controller withValue:(uint8_t)value onChannel:(uint8_t)channel

    Параметры

    controller

    Указывает стандартное число MIDI-контроллера. Допустимый диапазон 0 к 127.

    value

    Значение для контроллера. Допустимый диапазон 0 к 127.

    channel

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • sendMIDIEvent (_: data1:) - sendMIDIEvent:data1:

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

    Объявление

    Swift

    func sendMIDIEvent(_ midiStatus: UInt8, data1 data1: UInt8)

    Objective C

    - (void)sendMIDIEvent:(uint8_t)midiStatus data1:(uint8_t)data1

    Параметры

    midiStatus

    STATUS значение события MIDI.

    data1

    Байт данных события MIDI.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • sendMIDIEvent (_: data1:data2:) - sendMIDIEvent:data1:data2:

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

    Объявление

    Swift

    func sendMIDIEvent(_ midiStatus: UInt8, data1 data1: UInt8, data2 data2: UInt8)

    Objective C

    - (void)sendMIDIEvent:(uint8_t)midiStatus data1:(uint8_t)data1 data2:(uint8_t)data2

    Параметры

    midiStatus

    STATUS значение события MIDI.

    data1

    Первый байт данных события MIDI.

    data2

    Первый байт данных события MIDI.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • sendMIDISysExEvent (_:) - sendMIDISysExEvent:

    Отправляет событие «System Exclusive» MIDI в инструмент.

    Объявление

    Swift

    func sendMIDISysExEvent(_ midiData: NSData!)

    Objective C

    - (void)sendMIDISysExEvent:(NSData *)midiData

    Параметры

    midiData

    NSData объект, содержащий полное SysEx данные включая запуск (F0) и завершение (F7) байты.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • sendPitchBend (_: onChannel:) - sendPitchBend:onChannel:

    Отправляет событие «Pitch Bend» MIDI в инструмент.

    Объявление

    Swift

    func sendPitchBend(_ pitchbend: UInt16, onChannel channel: UInt8)

    Objective C

    - (void)sendPitchBend:(uint16_t)pitchbend onChannel:(uint8_t)channel

    Параметры

    pitchbend

    Значение pitchbend. Допустимый диапазон значений 0 к 16383.

    channel

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

    Обсуждение

    Если этот метод не вызывается, то изгиб подачи является значением по умолчанию 8192 (никакая подача).

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • sendPressure (_: onChannel:) - sendPressure:onChannel:

    Отправляет MIDI “событие” давления канала в инструмент.

    Объявление

    Swift

    func sendPressure(_ pressure: UInt8, onChannel channel: UInt8)

    Objective C

    - (void)sendPressure:(uint8_t)pressure onChannel:(uint8_t)channel

    Параметры

    pressure

    Значение давления. Допустимый диапазон 0 к 127.

    channel

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • sendPressureForKey (_: withValue:onChannel:) - sendPressureForKey:withValue:onChannel:

    Отправляет событие «Polyphonic key pressure» MIDI в инструмент.

    Объявление

    Swift

    func sendPressureForKey(_ key: UInt8, withValue value: UInt8, onChannel channel: UInt8)

    Objective C

    - (void)sendPressureForKey:(uint8_t)key withValue:(uint8_t)value onChannel:(uint8_t)channel

    Параметры

    key

    Ключ (примечание) число, к которому применяется событие давления. Допустимый диапазон 0 к 127.

    value

    Значение давления. Допустимый диапазон 0 к 127.

    channel

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • sendProgramChange (_: bankMSB:bankLSB:onChannel:) - sendProgramChange:bankMSB:bankLSB:onChannel:

    Отправляет MIDI события «Program Change» и «Bank Select» в инструмент.

    Объявление

    Swift

    func sendProgramChange(_ program: UInt8, bankMSB bankMSB: UInt8, bankLSB bankLSB: UInt8, onChannel channel: UInt8)

    Objective C

    - (void)sendProgramChange:(uint8_t)program bankMSB:(uint8_t)bankMSB bankLSB:(uint8_t)bankLSB onChannel:(uint8_t)channel

    Параметры

    program

    Указывает программу (предварительная установка) число в банке для загрузки. Допустимый диапазон 0 к 127.

    bankMSB

    Указывает старшее значащее значение байта для банка для выбора. Допустимый диапазон 0 к 127.

    bankLSB

    Указывает младшее значащее значение байта для банка для выбора. Допустимый диапазон 0 к 127.

    channel

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • sendProgramChange (_: onChannel:) - sendProgramChange:onChannel:

    Отправляет MIDI события «Program Change» и «Bank Select» в инструмент.

    Объявление

    Swift

    func sendProgramChange(_ program: UInt8, onChannel channel: UInt8)

    Objective C

    - (void)sendProgramChange:(uint8_t)program onChannel:(uint8_t)channel

    Параметры

    program

    Указывает программу. Допустимый диапазон 0 к 127.

    channel

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

    Обсуждение

    Инструмент будет загружен из банка, который был предыдущим набором MIDI “сообщения контроллера” Выбора Банка (0 и 31). Если ни один не был установлен, банк 0 будет использоваться.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

Запуск и останавливание игры
  • startNote (_: withVelocity:onChannel:) - startNote:withVelocity:onChannel:

    Отправляет событие «Note On» MIDI в инструмент.

    Объявление

    Swift

    func startNote(_ note: UInt8, withVelocity velocity: UInt8, onChannel channel: UInt8)

    Objective C

    - (void)startNote:(uint8_t)note withVelocity:(uint8_t)velocity onChannel:(uint8_t)channel

    Параметры

    note

    Число примечания (ключ) для игры. Допустимый диапазон 0 к 127.

    velocity

    Указывает объем, в котором играется примечание. Допустимый диапазон 0 к 127.

    channel

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

    См. также

    – stopNote:onChannel:

  • stopNote (_: onChannel:) - stopNote:onChannel:

    Отправляет событие «Note Off» MIDI в инструмент

    Объявление

    Swift

    func stopNote(_ note: UInt8, onChannel channel: UInt8)

    Objective C

    - (void)stopNote:(uint8_t)note onChannel:(uint8_t)channel

    Параметры

    note

    Число примечания (ключ) для остановки. Допустимый диапазон 0 к 127.

    channel

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

    См. также

    – startNote:withVelocity:onChannel: