Flutter音乐记谱插件music_notes的使用

music_notes是一个强大的Dart库，用于轻松处理音乐理论概念，并提供优雅且精心设计的API。本文将介绍如何在Flutter项目中使用该插件，并提供一个完整的示例demo。

功能

• 音符、变音记号和等音操作
• 音程、音质和五度圈
• 和弦、音阶、调性功能、转位和逆行
• 调式、调号和模式
• 频率和调律系统（开发中）

使用方法

1. 导入包

首先，在你的Dart代码中导入music_notes包：

import 'package:music_notes/music_notes.dart';

2. 创建音符

定义音符

你可以通过基音和变音记号定义一个音符，或者使用静态常量：

const noteEFlat = Note(BaseNote.e, Accidental.flat); // E♭
final noteC = Note.c; // C
final noteD = Note.d; // D
final noteF = Note.f; // F

获取基音

可以通过半音或序数获取基音：

final baseNoteD = BaseNote.fromSemitones(2); // BaseNote.d
final baseNoteA = BaseNote.fromSemitones(9); // BaseNote.a

final baseNoteE = BaseNote.fromOrdinal(3); // BaseNote.e
final baseNoteB = BaseNote.fromOrdinal(7); // BaseNote.b

改变音符

可以对音符进行升调或降调：

final noteCSharp = Note.c.sharp; // C♯
final noteDFlat = Note.d.flat; // D♭
final noteGDoubleFlat = Note.g.flat.flat; // G𝄫
final noteFTripleSharp = Note.f.sharp.sharp.sharp; // F𝄪♯

设置音高

可以将音符放置在特定的八度中，形成音高：

final pitchF4 = Note.f.inOctave(4); // F4
final pitchBFlat5 = Note.b.flat.inOctave(5); // B♭5

解析音符

可以从科学记谱法或赫尔姆霍兹记谱法解析音符：

final baseNoteB = BaseNote.parse('b'); // BaseNote.b
final noteASharp = Note.parse('a#'); // A♯
final pitchG5 = Pitch.parse("g''"); // G5
final pitchEFlat3 = Pitch.parse('Eb3'); // E♭3

3. 计算音程

创建音程

可以通过以下方式创建音程：

const intervalM10 = Interval.imperfect(Size.tenth, ImperfectQuality.major); // M10
final intervalD5 = Interval.d5; // d5
final intervalA6 = Size.sixth.augmented; // A6
final intervalP4 = Size.eleventh.simple.perfect; // P4

解析音程

可以从字符串解析音程：

final intervalM3 = Interval.parse('m3'); // m3
final intervalPMinus5 = Interval.parse('P-5'); // P-5
final intervalAA6 = Interval.parse('AA6'); // AA6

转置音符

可以使用音程转置音符：

final transposedNoteEFlat = Note.g.flat.transposeBy(-Interval.m3); // E♭
final transposedPitchFSharp4 = Note.b.inOctave(3).transposeBy(Interval.P5); // F♯4

4. 创建调式

定义调式

可以通过音符和调式模式创建调式：

const keyEMinor = Key(Note.e, TonalMode.minor); // E minor
final keyAFlatMajor = Note.a.flat.major; // A♭ major

获取调号

可以获取调式的调号：

final signatureD = Note.d.major.signature; // 2 (F♯ C♯)
final signatureEFlat = Note.e.flat.minor.signature; // -6 (B♭ E♭ A♭ D♭ G♭ C♭)

5. 示例Demo

以下是一个完整的示例，展示了如何在Flutter应用中使用music_notes插件：

import 'package:flutter/material.dart';
import 'package:music_notes/music_notes.dart';

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Music Notes Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: MyHomePage(),
    );
  }
}

class MyHomePage extends StatefulWidget {
  @override
  _MyHomePageState createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  String _output = '';

  void _calculateNotes() {
    final noteC = Note.c;
    final noteG = Note.g;

    final interval = noteC.interval(noteG);
    setState(() {
      _output = 'The interval between C and G is: $interval';
    });
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Music Notes Demo'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            Text(
              _output,
              style: TextStyle(fontSize: 20),
            ),
            SizedBox(height: 20),
            ElevatedButton(
              onPressed: _calculateNotes,
              child: Text('Calculate Interval'),
            ),
          ],
        ),
      ),
    );
  }
}

在这个示例中，我们创建了一个简单的Flutter应用，当点击按钮时，计算并显示C和G之间的音程。

结论

music_notes插件提供了丰富的音乐理论功能，可以帮助开发者轻松地处理各种音乐相关的操作。希望本文提供的内容能帮助你更好地理解和使用这个插件。如果你有任何问题或建议，请参考官方文档或提交issue到GitHub仓库。