bgmusic
動画に合う、パブリックドメインのカタログから実際のミュージックベッドを見つけます。ライブラリのダウンロードやクレジット表記は必要ありません。
組み込みで十分な場合
public/sfx/ にはすでに2つのベッドが同梱されており、リクエストは不要です。
music-bed.mp3: 60秒のアンビエントドローン。短い技術解説動画に適しています。pulse-bed.mp3: 112bpm、pulse-bed.cues.jsonに正確なキューのグリッドが含まれています。これは合成されたものであり、解析されたものではないため、ビートロックされたカットが推定ではなく正確に行える唯一のトラックです。
動画が短い、ナレーション主体、または音楽が単に無音でなければならない場合に使用してください。動画がローンチやプロモーション作品であり、ベッドがムードを担う場合には、外部を探しましょう。
2つのカタログ
| ソース | 内容 | サイズ |
|---|---|---|
lofi | btahir/open-lofi、10カテゴリの166のローファイトラック | トラックあたり約3MB |
cc0 | SoundSafari/CC0-1.0-Music、freepd、chosic、Free Music Archive、freesound、Pixabayからの約9200トラック | トラックあたり2〜15MB |
どちらもCC0-1.0です。パブリックドメイン、商用利用可能、クレジット表記不要、動画の説明にも何も必要ありません。これが、plan_sound_effects が依然としてユーザーを手動でPixabayに送る一方で、これら2つが組み込まれている理由です。
一つはっきり述べておくべき注意点があります：このコーパスはコミュニティが集約したもので、削除依頼に依存しています。そのため、各トラックのCC0の主張はメンテナによるものであり、あなたが読んだライセンスではありません。製品動画では問題ありませんが、証明ファイルにソースが記録されています。ライセンスの誤りが高くつく場合は、lofi に留まってください。これは1人の作者、1つのリリース、1つのライセンス声明です。
フロー
find_music_bed -> [ユーザーが試聴] -> import_music_bed -> plan_music_cues -> stitch_composition
1. find_music_bed
プレーンなムードやシーンを表す言葉（"calm focus coding"、"late night neon"、"warm upbeat"）でクエリします。タイトルとカテゴリがマッチングの対象です。
最初の呼び出しでインデックスが構築されます。これは約7回のGitHub API呼び出しで、output/music-index.json にキャッシュされます。以降の検索はローカル読み取りです。カタログが新しいリリースを公開した後にのみ、refresh: true を渡してください。
lofi のカテゴリは実際のメタデータであるため、category: "ambient-lofi" が機能します。コーパスのトラックにはカテゴリがありません。トラックは、それが提供されたサイトにちなんで名付けられたフォルダ内のファイル名です。何もマッチしない場合、ツールはプレーンなサンプルを返し、matchedQuery: false を設定します。これは、作曲家が実際にタイトルに入れるような言葉を試すためのシグナルであり、諦めるためのものではありません。
ユーザーに選択させてください。 タイトルとカテゴリを含む3〜5つの候補を返します。音楽は好みの問題であり、間違ったベッドは間違ったフォントよりも目立ちます。
2. import_music_bed
import_music_bed(id: "lofi:terminal-rain", out: "public/audio/music-bed.mp3", seconds: 45, start: 12)
ダウンロードに加えて行うこと：start から seconds 分だけトリミングし、フェードイン・フェードアウトを適用し、-20 LUFSにノーマライズして、ベッドがナレーションと競合するのではなく、その下に収まるようにします。raw: true を渡すとこれらすべてをスキップし、公開されたままのトラックを保持します。
配置場所：
public/audio/music-bed.mp3：コンポジションのベッド用。stitch_compositionが自動的にそのパスをアタッチするため、他に変更する必要はありません。public/imported_audios/（デフォルト）：その他のもの用。これは、組み込みパックから取得されていない素材を保持するフォルダです。
トラックの横に <file>.source.json と MUSIC-SOURCES.md の行（ID、タイトル、ソースリポジトリ、ライセンス、日付）を書き込みます。CC0はそのようなものを何も必要としません。これは、1年後にベッドの来歴が推測ではなくファイル読み取りでわかるようにするためのものです。
start を使用してトラックの途中から始めます。イントロは通常最も役に立たない部分であり、ダウンビートで始まるベッドは、意図的に編集されたように感じさせるために何もする必要がありません。
3. plan_music_cues
インポートされたファイルに対して呼び出します。pulse-bed.mp3 以外のトラックの場合、グリッドはオンセットエンベロープから推定されるため、計画のガイダンスとして扱ってください。すべてのカットではなく、主要な公開の一部を strongCues にスナップします。docs/STYLE.md に許容範囲が記載されています。
コストと制限
- 何もベンダリングされていません。open-lofi はそのトラックを554MBのリリースzip内にのみ公開しているため、インポートはHTTP範囲リクエストを介してそのzipのセントラルディレクトリを読み取り、選択したメンバーのバイトのみをプルします。554MBがダウンロードされることは決してありません。
- ベッドを整形するには、PATHに
ffmpegが必要です。raw: trueでは不要です。 - GitHubの認証なしのAPI制限は1時間あたり60リクエストです。インデックス構築には約7回かかります。頻繁に再構築するマシンでは
GITHUB_TOKENを設定してください。 - インデックスキャッシュは
output/の下にあります。これは、スキャフォールドされたプロジェクトがすでにgitignoreしている場所です。
やってはいけないこと
- プロジェクトにカタログ全体をコミットしないでください。1動画あたり1ベッドがここでの単位です。
- トラックを
public/sfx/に置かないでください。そのフォルダはパッケージに同梱されるパックであり、public/sfx/CREDITS.mdにはその内容と利用規約がない理由が記載されています。 - これを効果音に使用しないでください。
plan_sound_effectsは最初に組み込みパックをチェックし、その後でのみ外部を探します。これは効果音にとって正しい順序です。