パッケージ、リポジトリ、アプリカテゴリを検索

パッケージ詳細v2.0.0

dart_melty_soundfont

純粋なDartで書かれたサウンドフォントシンセサイザー(つまり'.sf2'プレーヤー)。

AndroidiOSmacOSWindowsLinux
30日間ダウンロード
2060
いいね数
51
Pub ポイント
140

パッケージをインストール

flutter pub add dart_melty_soundfont

パッケージ概要

公開情報に基づく選定ガイドです。参考としてご利用ください。

.sf2 オーディオサンプルを再生する純 Dart 実装のサウンドフォントシンセサイザーで、Flutterアプリケーションにおけるクロスプラットフォーム音楽再生を可能にします。ネイティブ依存関係なしに高品質な楽器音色を統合したい開発者向けに設計されています。Android、iOS、macOS、Windows、Linux など複数のプラットフォームをサポートしており、ポータブルな音声合成が必要な音楽アプリケーションに最適です。Dart の力を活かして、最小限の設定でリアルタイム音声レンダリングを実現します。

用途

  • カスタム楽器サウンドでMIDIファイルを再生する
  • 音楽教育アプリの構築
  • Flutterでインタラクティブな楽器を作成する
  • サンプリングされた楽器ライブラリの統合
  • クロスプラットフォーム音声アプリケーションの開発

主な機能

  • 純粋なDart実装
  • .sf2 サウンドフォントファイルをサポートしています
  • クロスプラットフォーム互換性
  • リアルタイムオーディオ合成
  • 軽量で統合が簡単
  • ネイティブコードは不要です

適している対象

  • 音楽アプリを開発するFlutter開発者
  • インタラクティブなオーディオを備えた教育ソフトウェア
  • ポータブル楽器の音色を必要とするアプリ
  • プラットフォーム固有のオーディオライブラリを避けるプロジェクト
  • コードのシンプルさとポータビリティを重視する開発者

注意事項

  • 低スペックのデバイスではパフォーマンスが異なる場合があります
  • 大きな .sf2 ファイルはメモリ使用量を増加させます
  • SoundFont 2.0形式に限定
  • オーディオリソースの適切な管理が必要です
  • 複雑なポリフォニーまたは高度なエフェクト向けに最適化されていません

元の README

関連するソースリポジトリの README 原文のスナップショットです。最新の内容はリポジトリをご覧ください。

dart_melty_soundfont is a SoundFont synthesizer (i.e. '.sf2' player) written in pure Dart.

It is a port of MeltySynth (C#, MIT License) written by Nobuaki Tanaka, to Dart.

https://github.com/sinshu/meltysynth

Dependencies

This package has no dependencies.

Maintanence

This project was specifically designed to not require maintanence, in large part by not having any dependencies. Apart from breaking changes to the Dart language (rare), it should be solid code that works for decades. It will work on any Dart SDK sdk>=2.12 indefinitely.

This package was written against Dart SDK 2.16.1.

Example

Synthesize a simple chord:

// Necessary Imports
import 'package:dart_melty_soundfont/dart_melty_soundfont.dart';
import 'package:flutter/services.dart' show rootBundle;

// load sf2
ByteData bytes = await rootBundle.load('assets/akai_steinway.sf2');

// Create the synthesizer.
Synthesizer synth = Synthesizer.loadByteData(bytes, 
    SynthesizerSettings(
        sampleRate: 44100, 
        blockSize: 64, 
        maximumPolyphony: 64, 
        enableReverbAndChorus: true,
    ));

// optional: print available instruments (aka presets)
List<Preset> p = synth.soundFont.presets;
for (int i = 0; i < p.length; i++) {
  String instrumentName = p[i].regions.isNotEmpty ? p[i].regions[0].instrument.name : "N/A";
  print('[preset $i] name: ${p[i].name} instrument: $instrumentName');
}

//  optional: select first instrument (aka preset)
synth.selectPreset(channel: 0, preset: 0);

// turn on some notes
synth.noteOn(channel: 0, key: 72, velocity: 120);
synth.noteOn(channel: 0, key: 76, velocity: 120);
synth.noteOn(channel: 0, key: 79, velocity: 120);
synth.noteOn(channel: 0, key: 82, velocity: 120);

// create a pcm buffer
ArrayInt16 buf16 = ArrayInt16.zeros(numShorts: 44100 * 3);

// render the waveform (1 second)
synth.renderMonoInt16(buf16);

// turn off a note
synth.noteOff(channel: 0, key: 72, velocity: 120);

// render another second
synth.renderMonoInt16(buf16);

Synthesize notes from a MIDI file playback:

// Necessary imports
import 'package:dart_melty_soundfont/dart_melty_soundfont.dart';
import 'package:flutter/services.dart' show rootBundle;

// Load the soundfont file
ByteData bytes = await rootBundle.load('assets/akai_steinway.sf2');

// Create the synthesizer
Synthesizer synth = Synthesizer.loadByteData(bytes);

// Load MIDI file from asset
ByteData midiBytes = await rootBundle.load('assets/arabesque.mid');
MidiFile midiFile = MidiFile.fromByteData(midiBytes);

// Start MIDI playback
MidiFileSequencer sequencer = MidiFileSequencer(synth);
sequencer.play(midiFile, loop: false);

// Change the playback speed.
sequencer.speed = 1.5;

// Render 10 seconds of playback into PCM buffer
ArrayInt16 buf16 = ArrayInt16.zeros(numShorts: 44100 * 10);
sequencer.renderMonoInt16(buf16);

Playing Sound

This library does not audibly make sound, it only generates the PCM waveform.

To actually hear something, you need to pass the generated PCM waveform to your device's speakers using PCM.

See the Example App for a flutter_pcm_sound + dart_melty_soundfont example.

Isolates

It is recommended to do your audio rendering in isolates or using compute. This will keep your UI fast & prevent audio stuttering.

Features

  • No memory allocation in the rendering process.

  • Wave synthesis

    • [x] SoundFont reader
    • [x] Waveform generator
    • [x] Envelope generator
    • [x] Low-pass filter
    • [x] Vibrato LFO
    • [x] Modulation LFO
  • MIDI message processing

    • [x] Note on/off
    • [x] Bank selection
    • [x] Modulation
    • [x] Volume control
    • [x] Pan
    • [x] Expression
    • [x] Hold pedal
    • [x] Program change
    • [x] Pitch bend
    • [x] Tuning
  • Effects

    • [x] Reverb
    • [x] Chorus
  • Other things

    • [x] Standard MIDI file support
    • [x] Loop extension support
    • [x] Performance optimization

License

DartMeltySoundFont is available under the MIT license.

References

  • SoundFont® Technical Specification
    http://www.synthfont.com/SFSPEC21.PDF

  • Polyphone Soundfont Editor
    Some of the test cases were generated with Polyphone.
    https://www.polyphone-soundfonts.com/

  • Freeverb by Jezar at Dreampoint
    The implementation of the reverb effect is based on Freeverb.
    https://music.columbia.edu/pipermail/music-dsp/2001-October/045433.html

カテゴリー

ソースリポジトリ

このパッケージを使用しているプロジェクト