FUN SFX
このフォルダをスキルルートとして使用します。コマンドを実行する前にその場所を特定してください。ユーザーの作業ディレクトリは別の場所にある可能性があります。Python 3.10+が自動検出をサポートしており、音声出力にはFFmpegがPATHに含まれている必要があります。
サウンドを探す
python3 <スキルルート>/scripts/sfx.py search "whoosh" --json を実行すると、絶対パス付きの候補が得られます。検索では、"failed attempt" や "photo capture" のようなシーン説明も受け付けます。タイトル、ID、カテゴリ、タグ、推奨用途、例にマッチし、複数の単語はすべて一致する必要があります。否定的なガイダンスは意図的に除外しています。全コレクションを表示するには list --json を、完全なレコードを表示するには show <id> を実行してください。人間が読める概要についてはカタログを参照してください。
提供されるすべての録音には個別のユースケースガイドが付属しています。推奨されるシーン、タイミング、避けるべき状況、および編集例が記載されています。単に一致するカテゴリだけでなく、レコードの usage フィールドを使用してシーンに適したサウンドを選択してください。これらは創造的な推奨であり、必須の使用ではありません。
タグはファイル名から派生したままです。audio_review.status を確認してください。7つの録音には自動音声分析ノートがあり、残りの64にはファイル名ベースの推奨事項（未確認の可聴コンテンツ）が付いています。自動ノートは音声を聞き間違える可能性もあるため、audio_review.uncertainty に注意してください。どの録音も人間による試聴が行われたとは主張していません。候補を選択する前に試聴してください。特に Walmart、Whoop、Spotlight などの曖昧な名前のものは注意が必要です。ファイルには音声、音楽、無音、複数の効果、または急激な音量変化が含まれている可能性があります。シネマティック・ウィッシュ・コレクションと長いホラークリップは、抜粋を選択する必要があります。タイミングガイドは視覚的なアクションに相対的であり、検証されたソースのイン/アウトポイントではありません。
キューを準備する
python3 <スキルルート>/scripts/sfx.py export <id> /absolute/output/cue.wav --start 0.2 --duration 0.8 --gain-db -8 --fade-ms 10
出力は48kHzのステレオPCM WAVです。--start はソースのオフセットです。タイムライン上の配置は別の編集作業です。このコマンドは既存の出力ファイルがある場合は拒否します。元の録音はそのまま保持してください。適度なゲインを使用し、会話の明瞭さを保ち、最終ミックスを試聴してください。1つの音量設定ですべての録音に適するわけではありません。
ユーザーの既存のビデオエディタまたは編集ツールを使用して、準備したキューを配置します。editing.md で、キューシートのフィールド、タイミングガイド、FFmpegミキシングの例を参照してください。選択したID、ソース抜粋、タイムライン上の位置、ゲインを記録して、編集を再現可能にしておいてください。すべてのカットにデフォルトでサウンドを追加しないでください。
権利と整合性
FUN SFX メンテナーはバンドルされたサウンドのいずれも所有していません。すべての権利はそれぞれの所有者に帰属します。サウンドコレクションを提示またはパッケージ化する際には、この所有権表示を保持してください。
コードとドキュメントはMITライセンスです。バンドルされた録音と抽出された音声は権利が未確認であり、そのライセンスから除外されています。ASSET_LICENSE.md を参照してください。録音をMIT、ロイヤリティフリー、または再配布が許可されているものとして説明しないでください。「no copyright」を含むファイル名はライセンスの証拠にはなりません。この編集を引き継ぐ場合やこのスキルをパッケージ化する場合も、この区別を維持してください。
ダウンロードまたは変更されたパックをチェックする場合は、python3 <スキルルート>/scripts/sfx.py verify を実行してください。catalog.json には、すべてのオリジナルおよび使用可能なオーディオファイルの移植可能なパス、技術メタデータ、SHA-256チェックサムが含まれています。