使用 Android Studio 开发一款弹钢琴app

news2024/11/16 7:50:56

A. 项目描述

本项目主要实现了【钢琴键盘的模拟】、【弹奏引导】以及【乐曲库】等功能。
钢琴键盘模拟：提供全尺寸键盘，并且根据用户的喜好来调整键盘的颜色样式。
弹奏引导：用户可以根据键盘上的提示符号 👆 来学习演奏。对于钢琴萌新/小白来说这个功能太方便了，可以像老手一样轻松弹奏各种曲目。
乐曲库：内置了曲谱，包括经典音乐、流行歌曲。用户可以跟随引导演奏这些曲目。
总之，这个app可以使得学习钢琴变得有趣和便捷，无论是钢琴初学者还是已经有一定经验的音乐爱好者，都可以从中受益。

B. 开发工具

Android Studio Dolphin | 2021.3.1 Patch 1
Java , JDK 11.0.13
Gradle , gradle-7.4

C. 功能设计

钢琴键盘模拟

PianoCanvasView类实现了钢琴键盘的绘制，它继承SurfaceView，可以在子线程中更新UI；

draw_all_keys方法，绘制了钢琴的所有键；

    void draw_all_keys(final Canvas canvas) {
        // 重置 canvas
        {
            Paint p = new Paint();
            p.setColor(Color.BLACK);
            canvas.drawPaint(p);
        }

        if (KEY_COLORS == null || null == PRESSED_KEY_COLORS || KEY_COLORS.length <1 || PRESSED_KEY_COLORS.length <1) {
            setKeyboardStyleColorful();
        }

        for (int i = 0; i < piano.get_keys_count(); i += 2) {
            // 绘制大琴键
            final int col_idx = (i / 2) % KEY_COLORS.length;
            Paint big_key_paint = new Paint();
            big_key_paint.setColor(piano.is_key_pressed(i) ? PRESSED_KEY_COLORS[col_idx] : KEY_COLORS[col_idx]);
            Piano.Key key = piano.get_area_for_key(i);
            if (key != null) {
                draw_key(canvas, key, big_key_paint);

                piano.onDrawPianoKey(this, canvas, i, key);
            }
        }

        // 在大键之后绘制小键
        for (int i = 1; i < piano.get_keys_count(); i += 2) {
            // 绘制小琴键
            Paint flat_key_paint = new Paint();
            flat_key_paint.setColor(piano.is_key_pressed(i) ? Color.GRAY : 0xFF333333);
            Piano.Key key = piano.get_area_for_flat_key(i);
            if (key != null) {
                draw_key(canvas, key, flat_key_paint);
            }
        }

        appConfigHandler.onPianoRedrawFinish(this, canvas);
        piano.onPianoRedrawFinish(this, canvas);
    }

onTouchEvent 方法捕捉屏幕上手指按下、抬起等动作；

钢琴键盘

弹奏引导

app通过在钢琴键上绘制手指符号（👆）来引导用户弹奏曲目，用户每按下一个键就发出一个对应的琴音。跟随着手指符号（👆）的变化，用户就可以弹奏出一个完整的曲调了。

在PianoConst类中，note2keyIdx常量就保存了音符与琴键位置的映射关系；
在Piano类中，updateMelodyFromAssets方法将乐曲资源转换成音符集合；
通过 Piano类的draw_emoji_on_piano_key方法将引导手指符号（👆）绘制在对应的琴键上。

    private void draw_emoji_on_piano_key(PianoCanvasView piano, Canvas canvas, int key_idx) {
        if (piano == null || canvas == null || key_idx < 0) {
            return;
        }
        // black: 1, 3, 7, 9, 11, 15 —— 奇数
        // white: 偶数

        // 👆 ✋
        String emoji = "\uD83D\uDC46";
        if (key_idx % 2 == 1) {
            piano.draw_emoji_on_black_key(canvas, emoji, key_idx);
        } else {
            piano.draw_emoji_on_white_key(canvas, emoji, key_idx);
        }
    }