Flutter简易乐谱展示插件 simple_sheet_music 的使用

simple_sheet_music 是一个用于在Flutter应用程序中显示简易乐谱的库。它包含了用于渲染五线谱、小节、谱号、音符及其他音乐符号的类。

功能特点

• 简易乐谱的渲染
• 支持多种谱号（如高音谱号、低音谱号）
• 支持不同的调号和临时记号
• 可以自定义音符时值和组合

示例效果

使用步骤

添加依赖

首先，在你的pubspec.yaml文件中添加对simple_sheet_music的依赖：

dependencies:
  flutter:
    sdk: flutter
  simple_sheet_music: ^版本号

记得将^版本号替换为最新的版本号，你可以在pub.dev上查找该包的最新版本。

示例代码

下面是一个完整的示例，展示了如何使用simple_sheet_music来创建并显示简单的乐谱。

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

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

class MyApp extends StatelessWidget {
  const MyApp({Key? key}) : super(key: key);

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepPurple),
        useMaterial3: true,
      ),
      home: const SimpleSheetMusicDemo(),
    );
  }
}

class SimpleSheetMusicDemo extends StatefulWidget {
  const SimpleSheetMusicDemo({super.key});

  @override
  State<SimpleSheetMusicDemo> createState() => SimpleSheetMusicDemoState();
}

class SimpleSheetMusicDemoState extends State<SimpleSheetMusicDemo> {
  late final Measure measure1;
  late final Measure measure2;
  late final Measure measure3;

  @override
  void initState() {
    measure1 = Measure([
      const Clef(ClefType.treble),
      const KeySignature(KeySignatureType.dMajor),
      const ChordNote([
        ChordNotePart(Pitch.b4),
        ChordNotePart(Pitch.g5, accidental: Accidental.sharp),
      ]),
      const Rest(RestType.quarter),
      const Note(Pitch.a4,
          noteDuration: NoteDuration.sixteenth, accidental: Accidental.flat),
      const Rest(RestType.sixteenth),
    ]);
    measure2 = Measure([
      const ChordNote([
        ChordNotePart(Pitch.c4),
        ChordNotePart(Pitch.c5),
      ], noteDuration: NoteDuration.sixteenth),
      const Note(Pitch.a4,
          noteDuration: NoteDuration.sixteenth, accidental: Accidental.flat)
    ]);
    measure3 = Measure(
      [
        const Clef(ClefType.bass),
        const KeySignature(KeySignatureType.cMinor),
        const ChordNote(
          [
            ChordNotePart(Pitch.c2),
            ChordNotePart(Pitch.c3),
          ],
        ),
        const Rest(RestType.quarter),
        const Note(Pitch.a3,
            noteDuration: NoteDuration.whole, accidental: Accidental.flat),
      ],
      isNewLine: true,
    );
    super.initState();
  }

  @override
  Widget build(BuildContext context) {
    final sheetMusicSize = MediaQuery.of(context).size;
    final width = sheetMusicSize.width;
    final height = sheetMusicSize.height / 2;
    return Scaffold(
      appBar: AppBar(title: const Text('Simple Sheet Music')),
      body: Center(
        child: DecoratedBox(
          decoration: BoxDecoration(
            border: Border.all(),
            borderRadius: BorderRadius.circular(10),
          ),
          child: SimpleSheetMusic(
            height: height,
            width: width,
            measures: [measure1, measure2, measure3],
          ),
        ),
      ),
    );
  }
}

这段代码创建了一个基本的Flutter应用，并且在其主页面上展示了包含三个小节的简单乐谱。每个小节由一系列的音符、休止符和其他音乐符号组成。通过调整SimpleSheetMusic组件的height和width属性，可以控制乐谱视图的大小。