mirror of https://github.com/qmk/qmk_firmware.git synced 2024-11-29 06:30:17 +00:00

zvecr ea193b4237 Deploying to gh-pages from @ qmk/qmk_firmware@01f31bf28e 🚀

2022-09-15 00:05:30 +00:00

14 KiB

Raw Blame History

オーディオ

キーボードは音を出すことができます！Planck、Preonic あるいは特定の PWM 対応ピンにアクセスできる AVR キーボードがある場合は、単純なスピーカーを接続してビープ音を鳴らすことができます。これらのビープ音を使ってレイヤーの変化、モディファイア、特殊キーを示したり、あるいは単にイカした8ビットの曲を鳴らすことができます。

最大2つの同時オーディオ音声がサポートされ、1つはタイマー1によってもう一つはタイマー3によって駆動されます。以下のピンは config.h の中でオーディオ出力として定義することができます:

Timer 1: #define B5_AUDIO #define B6_AUDIO #define B7_AUDIO

Timer 3: #define C4_AUDIO #define C5_AUDIO #define C6_AUDIO

rules.mk に AUDIO_ENABLE = yes を追加すると、他の設定無しで自動的に有効になる幾つかの異なるサウンドがあります:

STARTUP_SONG // キーボードの起動時に再生 (audio.c)
GOODBYE_SONG // QK_BOOT キーを押すと再生 (quantum.c)
AG_NORM_SONG // AG_NORM キーを押すと再生 (quantum.c)
AG_SWAP_SONG // AG_SWAP キーを押すと再生 (quantum.c)
CG_NORM_SONG // CG_NORM キーを押すと再生 (quantum.c)
CG_SWAP_SONG // CG_SWAP キーを押すと再生 (quantum.c)
MUSIC_ON_SONG // 音楽モードがアクティブになると再生 (process_music.c)
MUSIC_OFF_SONG // 音楽モードが非アクティブになると再生 (process_music.c)
CHROMATIC_SONG // 半音階音楽モードが選択された時に再生 (process_music.c)
GUITAR_SONG // ギター音楽モードが選択された時に再生 (process_music.c)
VIOLIN_SONG // バイオリン音楽モードが選択された時に再生 (process_music.c)
MAJOR_SONG // メジャー音楽モードが選択された時に再生 (process_music.c)

config.h の中で以下のような操作を行うことで、デフォルトの曲を上書きすることができます:

#ifdef AUDIO_ENABLE
  #define STARTUP_SONG SONG(STARTUP_SOUND)
#endif

サウンドの完全なリストは、quantum/audio/song_list.h で見つかります - このリストに自由に追加してください！利用可能な音は quantum/audio/musical_notes.h で見つかります。

特定の時にカスタムサウンドを再生するために、以下のように曲を定義することができます(ファイルの上部付近に):

float my_song[][2] = SONG(QWERTY_SOUND);

以下のように曲を再生します:

PLAY_SONG(my_song);

または、以下のようにループで再生することができます:

PLAY_LOOP(my_song);

オーディオがキーボードに組み込まれていない時に問題が起きる事を避けるために、#ifdef AUDIO_ENABLE / #endif で全てのオーディオ機能をくるむことをお勧めします。

オーディオで利用可能なキーコードは以下の通りです:

AU_ON - オーディオ機能をオン
AU_OFF - オーディオ機能をオフ
AU_TOG - オーディオ機能を切り替え

!> これらのキーコードは全てのオーディオ機能をオンおよびオフにします。オフにするとオーディオフィードバック、オーディオクリック、音楽モードなどが完全に無効になります。

ARM オーディオボリューム

ARM デバイスの場合、DAC サンプル値を調整できます。キーボードがあなたやあなたの同僚にとって騒々しい場合、config.h 内の DAC_SAMPLE_MAX を使って最大量を設定することができます:

#define DAC_SAMPLE_MAX 65535U

音楽モード

音楽モードは列を半音階に、行をオクターブにマップします。これは格子配列キーボードで最適に動作しますが、他のものでも動作させることができます。0xFF 未満の全てのキーコードはブロックされるため、音の演奏中は入力できません - 特別なキー/mod があればそれらは引き続き動作します。これを回避するには、音楽モードを有効にする前(あるいは後)で、KC_NO を使って別のレイヤーにジャンプします。

メモリの問題により、録音は実験的です - 奇妙な動作が発生した場合は、キーボードの取り外しと再接続で問題が解決するでしょう。

利用可能なキーコード:

MU_ON - 音楽モードをオン
MU_OFF - 音楽モードをオフ
MU_TOG - 音楽モードの切り替え
MU_MOD - 音楽モードの循環
- CHROMATIC_MODE - 半音階。行はオクターブを変更します
- GUITAR_MODE - 半音階、ただし行は弦を変更します (+5 階)
- VIOLIN_MODE - 半音階。ただし行は弦を変換します (+7 階)
- MAJOR_MODE - メージャースケール

音楽モードでは、以下のキーコードは動作が異なり、通過しません:

LCTL - 録音を開始
LALT - 録音を停止/演奏を停止
LGUI - 録音を再生
KC_UP - 再生をスピードアップ
KC_DOWN - 再生をスローダウン

ピッチ標準 (PITCH_STANDARD_A) はデフォルトで 440.0f です - これを変更するには、config.h に以下のようなものを追加します:

#define PITCH_STANDARD_A 432.0f

音楽モードも完全に無効にすることができます。コントローラの容量が足りなくて困っている場合に役に立ちます。無効にするには、これを config.h に追加します:

#define NO_MUSIC_MODE

音楽マスク

デフォルトで、MUSIC_MASK は keycode < 0xFF に設定されます。これは、0xFF 未満のキーコードが音に変換され、何も出力しないことを意味します。config.h の中で以下のものを定義することで、これを変更することができます:

#define MUSIC_MASK keycode != KC_NO

これは全てのキーコードを捕捉します - これは、キーボードを再起動するまで、音楽モードで動けなくなることに注意してください！

どのキーコードを引き続き処理するかを制御する、より高度な方法については、<keyboard>.c の中の music_mask_kb(keycode) および keymap.c の中の music_mask_user(keycode) を使うことができます:

bool music_mask_user(uint16_t keycode) {
  switch (keycode) {
    case RAISE:
    case LOWER:
      return false;
    default:
      return true;
  }
}

false を返すものはマスクの一部では無く、常に処理されます。

音楽マップ

デフォルトでは、音楽モードはキーのスケールを決定するために列と行を使います。キーボードレイアウトに一致する長方形のマトリックスを使うキーボードの場合、これで十分です。しかし、(Planck Rev6 あるいは多くの分割キーボードなどのように)より複雑なマトリックスを使うキーボードの場合、非常に歪んだ感じを受けることになります。

しかしながら、音楽マップオプションにより、音楽モードのためにスケーリングを再マップすることができるため、レイアウトに一致し、より自然になります。

この機能を使うには、#define MUSIC_MAP を config.h ファイルに追加します。そして、キーボードの名前.c または keymap.c に uint8_t music_map を追加します。

const uint8_t music_map[MATRIX_ROWS][MATRIX_COLS] = LAYOUT_ortho_4x12(
	36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47,
	24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35,
	12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23,
	 0,  1,  2,  3,  4,  5,  6,  7,  8,  9, 10, 11
);

キーボードが使用する LAYOUT マクロも使用したいでしょう。これは正しいキーの位置にマップします。キーボードレイアウトの左下から開始し、右に移動してさらに上に移動します。完全なマトリックスができるまで、全てのエントリを入力します。

これを実装する方法の例として、Planck Keyboard を見ることができます。