SmartRandomPlayer

詳細操作ガイド

曲の登録方法

• 対応形式：mp3, wav, ogg, m4a, aac, flac, wma, opus, webm
• 登録制限：
  • 各レベル最大50曲まで
  • 全体で最大50曲まで
  • ⚠️ 全体で50曲に達すると新規レベルは追加できません
  • ⚠️ 一度登録したレベルは追加登録不可
  • 例：レベル1に30曲、レベル2に20曲登録すると、全体で50曲に達するため、レベル3以降のフォームは表示されません
• 登録順序：レベル1から順番に（レベル1→2→3→4→5）
• 初回アクセス権限：ファイル選択時に権限を許可してください
• ファイル管理の注意： 登録後はファイルを移動・リネームしないこと

レベルシステムの仕組み

• レベルの意味：
  • レベル5：最も頻繁に選ばれる（お気に入り曲）
  • レベル4：よく選ばれる（気分が上がる曲）
  • レベル3：そこそこ選ばれる（普通に好きな曲）
  • レベル2：あまり選ばれない（時々聴きたい曲）
  • レベル1：たまに選ばれる（聞き飽きたけどたまに聴きたい曲）
• 自動レベル降格：
  • 再生回数がレベル値に達すると自動的に1つ下のレベルへ
  • 例：レベル3の曲を3回再生→自動でレベル2へ
  • 降格時に再生回数と再生済みフラグがリセット
• 手動レベル変更：
  • 「データ管理」から任意のレベルへ変更可能
  • 変更時に再生回数と再生済みフラグがリセット

ランダム選曲設定

• 確率分布モード：
  • 一次関数：レベル差による偏りが緩やか
  • 二次関数：バランスの良い偏り（推奨）
  • 指数関数：高レベル曲が極端に選ばれやすい
• 重み付け強度（0-9）：
  • 0 = 完全ランダム（全曲同確率）
  • 5 = 標準的な重み付け
  • 9 = 最も強い偏り（高レベル優先）
• 設定の保存：変更は即座に自動保存

プレーヤー機能

• ランダム再生：設定に基づいて自動選曲
• 連続再生：ONで曲終了後に自動で次曲を選曲
• 全曲再生済み時：自動でリセットされ、最初から選曲再開
• この曲のデータを編集：再生中の曲を管理画面で即編集

曲リストの活用

• 表示順：レベル降順→曲名昇順で自動ソート
• 曲名クリック：データ管理画面へ移動＆自動入力
• 再生ボタン：その曲を即座に再生開始
• 削除ボタン：確認後に曲を削除（再生中でも可）
• 現在再生中：オレンジ色でハイライト表示

データ管理機能

• レベル変更：
  • 曲リストから曲名をクリックで自動入力
  • 移動先レベルを選択して実行
  • 空きレベルは自動で詰められる
  • 💡 最大レベル + 1まで移動可能（レベル5を超えない）
    例：レベル1, 2が存在する場合、レベル3への移動も可能（自動で新規作成）。お気に入りの曲を上位レベルに上げることができます
• 曲の削除：
  • 個別に削除可能（再生中でも削除可）
  • 削除後、レベルは自動で整理
  • 全体で50曲に達している場合、曲を削除してページをリロードすると新しいレベルのフォームが表示されます
• 全データリセット：
  • すべての楽曲と設定を削除
  • ページが自動リロードされ初期状態へ

ファイルアクセス権限について

• 権限の仕組み：
  • 登録した音楽ファイルへのアクセスには、ブラウザの許可が必要です
  • ブラウザを閉じると権限がリセットされます
• 再起動後の権限取得：
  • ブラウザ再起動後、初回の「ランダム再生」ボタン押下時に権限確認ダイアログが表示されます
  • 複数ファイルを登録している場合、一括で許可できるダイアログが表示されます
  • 「許可」を選択すると、登録済みの全ファイルにアクセス可能になります
• PWAでインストールした場合：
  • 通常のブラウザ使用時と同様に、アプリ起動後の初回再生時に権限確認が必要です

PWAとして使う（ホーム画面に追加）

• PWAとは：
  • PWA（Progressive Web App）は、Webサイトをスマートフォンやパソコンの「アプリ」のように使える仕組みです
  • 通常のアプリと異なり、アプリストアからダウンロードする必要はありません
  • ブラウザから直接「インストール」するだけで、ホーム画面やデスクトップにアイコンが追加されます
• 通常のブラウザ利用との違い：
  • 通常：毎回ブラウザを開いてURLを入力、またはブックマークからアクセス
  • PWA：ホーム画面のアイコンをタップするだけで起動
  • PWAではブラウザのアドレスバーやタブが非表示になり、専用アプリのような見た目で使えます
• インストール方法（Chrome/Edgeの場合）：
  • パソコン：アドレスバー右側に表示されるインストールアイコン（四角に矢印のマーク）をクリック
  • スマートフォン：ブラウザのメニューから「ホーム画面に追加」または「アプリをインストール」を選択
  • 表示されるダイアログで「インストール」を選択すれば完了
• PWAのメリット：
  • ホーム画面やデスクトップから1タップ（1クリック）で起動
  • アプリらしい全画面表示で操作に集中できる
  • ブックマークより見つけやすく、アクセスが簡単
• アップデートの反映方法：
  • アプリを完全に終了してください（バックグラウンドからも閉じる）
  • 再度アプリを起動すると最新版に更新されます
  • 通常のブラウザ利用時と同様、常にインターネット接続が必要です
• 注意事項：
  • このアプリはオフラインでは使用できません（インターネット接続が必要）
  • PWAをインストールしなくても、通常のブラウザからも同じように利用できます
  • インストールは任意です。お好みに応じてご利用ください

困ったときは

• ファイルアクセスエラー：
  • 権限確認ダイアログで「許可」を選択してください
  • ダイアログが表示されない場合は、ページをリロードしてから再度お試しください
  • ファイルが移動・削除・リネームされていないか確認
  • 上記で解決しない場合は、該当曲を削除して再登録してください
• 曲が再生されない：
  • 対応形式か確認（mp3推奨）
  • ファイルが移動/削除/リネームされていないか確認
  • エラーが続く場合は、該当曲を削除して再登録
• 追加登録したい：
  • 一度登録したレベルへの追加は不可
  • 全体で50曲に達している場合は、新規レベルのフォームが表示されません
  • さらに曲を追加したい場合は、不要な曲を削除するか、全データリセット後に再登録が必要
• 50曲以上登録できない：
  • このアプリは全体で50曲までの制限があります
  • 不要な曲を削除してから新しい曲を追加してください
  • または全データリセット後、改めて50曲以内で登録してください
• ファイルを整理したい：
  • 音楽ファイルの整理は登録前に完了させる
  • 登録後の移動・リネームは避ける
• アプリが更新されない（PWA使用時）：
  • アプリを完全に終了してください（タスクマネージャーやアプリスイッチャーから終了）
  • 再度アプリを起動すると最新版が反映されます
  • それでも更新されない場合は、一度アンインストールして再インストールしてください