Music Player

あなたの個人ライブラリ のための音楽プレーヤー。長年蓄積したFLACコレクション、CDからリッピングしたMP3、ダウンロードしたポッドキャスト、ライブ録音。自宅HDDからの直接ストリーミング、バックグラウンド再生（画面オフで再生継続）、本物のスペクトラムビジュアライザー 付きで、ログインしたあらゆるデバイス（携帯、タブレット、ノートブック、スマートTV）で動作するプレーヤー内のすべて。

Spotifyを考えて、ただし自分のファイルで月額料金なし。

---

ハイライト

🎵

プレイリスト

クラウドへの自動同期付きでカスタムプレイリストを作成・整理。

📡

ネットワークストリーミング

世界のどこからでも自宅HDDから音楽を聴く。

📱

バックグラウンド再生

携帯の画面を消しても聴き続ける。

🌈

ビジュアライザー

周波数スペクトラムのリアルタイムアニメーション。

---

音楽の追加

📁 ファイルマネージャー経由

ファイルマネージャーでオーディオファイル（.mp3、.wav、.ogg、.flac）を見つけて ダブルクリック。Music Playerが自動的に開いて再生を開始します。

🔗 URL経由

インターネットからアクセス可能なオーディオファイルの直接URLを貼り付けます。ホスティングまたはCDNからの直接リンクに便利。

📂 フォルダ全体を追加

複数のオーディオファイルを含むフォルダ全体を一度にライブラリにインポート。

💾 ネットワークディスクから サーバー

サーバーの マップされたディスク をナビゲートし、HDDから音楽のフォルダ全体を追加。

---

ネットワークディスクストリーミング

🌟 注目機能！ Spotifyのような個人ストリーミングサービスのように、世界のどこからでも自宅HDDの音楽を聴く — ただしあなたの音楽コレクション付き。

仕組み

1. MP3ファイルは あなたのコンピュータまたはサーバーのHDD にあります
2. これらのファイルはRoqueOS Serverで ボリュームとしてマップ されます
3. Music Playerはサーバー経由で HTTPストリーミング でアクセスします
4. インターネットに接続された任意のデバイスから聴きます

ステップバイステップ

1. docker-compose.yml で音楽フォルダをマップ:

services:
  roqueos-server:
    volumes:
      - ./data:/app/data
      - /var/run/docker.sock:/var/run/docker.sock
      - /home/user/Music:/app/disks/Music # ← あなたの音楽HDD

2. サーバーを再起動:

docker compose down && docker compose up -d

3. RoqueOSで、Music Playerを開いてネットワークフォルダを追加:

• フォルダ追加 ボタンをクリック
• ネットワークセレクターで Music ディスクをナビゲート
• 目的のフォルダを選択して確認
• フォルダ内のすべての音楽がライブラリにインポートされます

4. 完了！どこからでも聴く。

外部アクセスのために Cloudflare Tunnels を使用している場合、ストリーミングはインターネット接続のある世界のどこからでも動作します。

---

バックグラウンド再生

📱 モバイルに必須の機能！ 携帯の画面をロックしたり、アプリを切り替えてもMusic Playerは再生し続けます。

携帯でどのように動作するか

RoqueOSはブラウザの Media Session API を使用し、以下を可能にします:

• 画面オフ — 音楽は通常通り再生し続けます
• ロック画面のコントロール — 再生、一時停止、次、前がシステム通知に表示
• イヤホンのコントロール — Bluetoothヘッドフォンのボタンが通常通り動作
• アプリを切り替える — 他のアプリを開いたときに音楽は停止しません

要件

• インストールされたPWA または ネイティブアプリ（iOS/Android）でRoqueOSを使用
• 最新版のChrome、SafariまたはEdgeブラウザ
• iOSでは、バックグラウンド再生が機能するためにPWAをホーム画面にインストール

ヒント

携帯での最高のストリーミング体験のために、RoqueOSをPWAとしてインストールするか、App Store または Microsoft Store からネイティブアプリをダウンロード。

---

プレイリストの管理

プレイリストの作成

1. サイドパネルの プレイリスト エリアで、+ 新しいプレイリスト をクリック
2. プレイリストに名前を付ける
3. ライブラリから音楽をプレイリストにドラッグするか、音楽のコンテキストメニューを使用

整理

• 再順序付け — プレイリスト内で音楽をドラッグして順序を変更
• 削除 — 音楽を右クリックして「プレイリストから削除」を選択
• 名前変更 — プレイリスト名をクリックして編集
• 削除 — コンテキストメニューでプレイリスト全体を削除

同期

すべてのプレイリストと音楽ライブラリはあなたのアカウントで 自動的に同期 されます。コンピュータでプレイリストを作成すると、次に携帯でMusic Playerを開いたときに表示されます。

---

オーディオビジュアライザー

Music Playerには、音楽の再生に反応するリアルタイムの 周波数スペクトラムビジュアライザー があります。アニメーションはリズムに応じて踊るカラフルなバーで低音、中音、高音の周波数を表示します。

CROSS-ORIGINに関するメモ

ビジュアライザーはローカルファイルと同一オリジンで完璧に動作します。異なるドメインのネットワークディスクストリーム（例: アプリが localhost で実行中に casa.roqueos.com にアクセス）の場合、ビジュアライザーはブラウザのCORS制限のために代替パルスモードを使用します — 音楽は通常通り再生し続けます。

---

デスクトップのメディアウィジェット

音楽が再生中の場合、Music Playerウィンドウを開かずに迅速な制御を可能にする ミニプレーヤー がRoqueOSタスクバーに表示されます:

• ⏯️ Play / Pause
• ⏭️ 次のトラック
• ⏮️ 前のトラック
• 🔊 ボリューム制御

---

サポートされる形式

形式	拡張子	サポート
MP3	.mp3	✅ すべてのブラウザ
WAV	.wav	✅ すべてのブラウザ
OGG Vorbis	.ogg	✅ Chrome、Firefox、Edge
FLAC	.flac	✅ Chrome、Edge、Safari 14.1+
AAC	.aac、.m4a	✅ すべてのブラウザ
WebM Audio	.webm	✅ Chrome、Firefox、Edge

---

使用のヒント

クイックヒント

• ライブラリで音楽をすぐに再生するには ダブルクリック
• 音楽をプレイリストに追加するには コンテキストメニュー（右クリック）を使用
• プレーヤーはアプリを再度開いたときに再生 位置とキュー を記憶
• リモートストリーミングの品質を向上させるには、MP3やAACのようなコンパクトな形式を使用
• Cloudflare Tunnelsを使えば、ポートを公開せずにストリーミングが世界中で動作