📱 XMSLEEP

📱 スクリーンショット

---

🌐 ウェブ版

インストール不要で、ブラウザからすべての機能を体験できます：113 種類の自然音 · 自由なミックス · シームレスループ · 6 言語 · カウントダウンタイマー。サウンドリストはアプリと同期しています。

👉 オンラインで再生: tosencen.github.io/XMSLEEP/player.html

アプリ内 設定 → その他 → ウェブ版 からもワンタップでアクセスでき、リンクをコピーして共有できます。

---

📱 概要

XMSLEEP はホワイトノイズと自然音の再生に特化した Android アプリです。雨音、焚き火、鳥のさえずりなど、厳選された高品質な自然音でリラックス、集中力向上、睡眠の質向上をサポートします。Material Design 3 に準拠した、クリーンで美しいインターフェースを備えています。

✨ 機能

🎵 オーディオ機能

• 多彩なホワイトノイズ: 雨、焚き火、雷、鳥のさえずり、虫の音など、多数の自然音
• オンラインオーディオ: GitHub から動的にオーディオリソースを追加可能
• ローカルオーディオ: 端末内のオーディオファイル再生に対応
• シームレスループ: 途切れないループ再生で没入感を提供
• 音量コントロール: サウンドごとに個別音量調節、または一括調整
• 音量保存: 設定はアプリ再起動後も自動保持
• Bluetooth ヘッドセット対応: 切断時に自動停止
• Bilibili ラジオ: Bilibili ライブ配信ルームを検索・再生、お気に入りルームをピン留め可能
• 瞑想睡眠: 内蔵の瞑想音声をダウンロードしてオフライン再生可能

🎨 インターフェース

• 美しいアニメーション: 各サウンドに WebP アニメーションを搭載
• Material Design 3: 最新のデザインガイドラインを採用
• テーマ切替: ライト/ダークモード、システムテーマに自動追従
• カスタムテーマ: 多彩なカラーテーマとダイナミックカラー対応

⚙️ 便利機能

• タイマー機能: 自動停止時間を設定可能
• プリセット: 3 つのプリセット、各最大 10 個のサウンドを保存
• お気に入り: 好みのサウンドを保存
• 最近再生: 再起動時に最近の再生リストを表示
• フローティングボタン: 再生中のサウンドを表示、一時停止・展開可能
• スマート操作: フローティングボタンとプリセットは排他的、スクロール時に自動格納
• 自動更新: GitHub Releases によるアップデート確認

🌐 ウェブ版

• オンラインプレイヤー: ブラウザですぐに使用可能。113 種類の自然音を自由にミックス、シームレスループ、個別音量調整
• 多言語対応: 中国語/英語/日本語/韓国語/ロシア語/繁体中国語の 6 言語
• カウントダウンタイマー: カスタムカウントダウンと自動停止、リアルタイム表示
• 再生中パネル: 再生中のサウンドを一覧表示・停止・音量調整
• 読み込み最適化: ファーストビュー先読み + LRU キャッシュで即時再生

🛠️ 技術スタック

• Kotlin - メイン開発言語
• Jetpack Compose - モダン UI フレームワーク
• Material Design 3 - UI デザインシステム
• ExoPlayer/Media3 - オーディオ再生エンジン
• OkHttp - ネットワーク通信
• Gson - JSON パース
• Kotlinx Serialization - JSON シリアライズ
• Coil - 画像読み込み
• WebP - アニメーション
• MaterialKolor - 動的テーマカラー生成
• Accompanist - Pull-to-refresh
• Hilt - 依存性注入フレームワーク
• Lottie - 高品質アニメーションレンダリング
• Web Audio API - ウェブ版のシームレスループ再生（サンプル精度）

📦 現在のバージョン

• バージョン: 2.3.5
• Version Code: 50
• 最小 SDK: Android 8.0 (API 26)
• ターゲット SDK: Android 15 (API 35)

🆕 最新アップデート (v2.3.5)

🎨 新機能

• 瞑想オフラインダウンロード：音声リスト右下のバッジでワンタップDL（未DL/DL中/DL済みの3状態）、成功/失敗ともに Toast 通知、DL済み音声はオフライン再生可能
• ページ全体スクロール：瞑想プレーヤーを固定領域スクロールからページ全体スクロールへ変更。タイトルバーはスクロールで折りたたみ、末尾に余白を追加して遮蔽を防止

🐛 修正

• オフライン再生クラッシュ：ローカル音声をファイルソースで再生し、file:// をネットワークソースに渡すことで起きていたクラッシュを修正
• Bilibili 音声 403：UA/Referer/Origin ヘッダーを追加し、音声の取得とダウンロードが拒否される問題を修正
• 更新チェック安定化：gh-proxy ミラーへフォールバック、ダウンロードのバイト整合性検証と既存ファイルの再利用

✨ 改善

• バッジの柔和な区別：DL済みは淡いグリーン、未DLはグレーで一目で分かる
• デッドコード削除：未使用インポート・参照ゼロ関数・冗長な文字列キーを一括削除

🆕 最新アップデート (v2.3.4)

🎨 新機能

• フロストガラスダイアログ：FrostedGlassSheet コンポーネントを新設し、グローバルダイアログとボトムシートを統一改造（MD3 ドラッグハンドル付き）
• 呼吸フロントグラウンドサービス：フェーズ状態マシンを前台サービスへ移行し多言語音声ガイドを追加、リスト無限ページング、終了時自動クリーンアップ
• テーマカラーグリッド：XMVISIO スタイル3色円グリッド＋中心チェックアニメーション。内蔵背景は自動で専用テーマカラーに合わせ
• セカンダリページトップバー：スクロールで隠れ、戻ると再表示。タイトルとコンテンツの重なりを解消
• タイマーダイヤル：カスタム時間は M3 円形タイムピッカーに変更

✨ 改善

• QWeather キー検証：保存前に host/key を強制検証、失敗時はダイアログにエラー表示
• 更新のダウンロードソース切替と低速ソース切り替え；ProGuard 精確 keep ルール、バックアップから機密 SP を除外、多言語文言修正（繁体字言語コード修正）

🐛 修正

• ダイアログ入退場アニメーションの硬さ、ボトムダイアログの左右二重枠
• 背景設定コールバック、位置権限の更新、振動スイッチの意味論（P0）
• なし/カスタム背景に戻ってもダイナミックカラーが強制 ON にならない問題
• 一言履歴ダイアログの未接続リフレッシュボタンを非表示；呼吸通知アイコンを塗りつぶしスタイルに

🆕 最新アップデート (v2.3.3)

🎨 新機能

• 毎日一言のランダム背景：毎日一言ダイアログの背景に Bing の日替わり壁紙をランダム採用（メモリのみキャッシュ・ディスク不使用）。文字は下端揃え・濃いグラデーションで可読性向上。共有/保存ポスターも同画像を使用
• 不適切ワード除去：毎日一言から自傷・重度の否定的表現（自殺・うつ等）を自動ブロック。API は再取得、ローカルはスキップ

✨ 改善

• 毎日一言ダイアログ：画面の 2/3 高さに固定し、長文はスクロール。更新バッジを右上に移動し角丸に

🆕 最新アップデート (v2.3.2)

🎨 新機能

• 和風天気ソース（BYOK）：天気はユーザー自身の和風天気キー（設定で Host + Key 入力）に対応。未設定時は Open-Meteo に自動フォールバック。都市単位の位置情報＋多言語

✨ 改善

• 天気カード：都市と日付を一行に統合（例「上海市 8月25日 火曜日」）し癒やしの文言の上に配置。ソースバッジを削除
• 座標オフセット：WGS84 → GCJ02 変換で国内位置精度を向上

🆕 最新アップデート (v2.3.1)

🎨 新機能

• ウェブ版オンラインプレイヤー: GitHub Pages のウェブ版を追加。113 種類の自然音、自由なミックス、シームレスループ、6 言語対応、サウンドリストはアプリと同期。インストール不要ですぐに利用可能
• アプリのウェブ版入口: 設定の「その他」モジュールに「ウェブ版」を追加。ワンタップでオンラインプレイヤーを開き、リンクコピーにも対応
• 白黒モードテーマ: モノクロテーマを追加し、ミニマルなビジュアルに
• トマトタイマーのバックグラウンド計時: ページを離れても計時継続、スケールに現在のフェーズ時間を表示
• トマト設定シートのカード化: カードスタイルのシート + 終了音の試聴 + 休憩時間の調整可能
• 通知欄の瞑想コントロール: 通知欄/ロック画面から瞑想オーディオを直接操作可能
• 数量の複数形対応: 英語/ロシア語などの数量表示をローカライズ（plurals）

✨ 改善

• 権限の厳格化: 権限宣言を整理し、プライバシー露出を低減
• Firebase 統計とクラッシュレポート: 匿名の利用統計とクラッシュ収集。個人情報は収集しません
• 依存関係のアップグレード: okhttp 5.3.2、gson 2.11.0、androidx.media 1.8.0、core-splashscreen 1.2.0
• リソースと署名の整理

🐛 修正

• カスタムカウントダウンの表示問題
• 呼吸サービスの登録、通知のローカライズ

🆕 最新アップデート (v2.3.0)

🎨 新機能

• トマトタイマー終了音: 4種類のフリーサウンド（チャイム/ディンドン/マリンバ/ウィンドチャイム）を内蔵。集中終了時に自動再生
• トマトタイマー終了バイブ: 集中終了時に自動で振動でお知らせ。設定でオン/オフ可能
• トマト設定シート: トマトページ右上の歯車から終了音・完了アニメーション・バイブを設定。シートは全画面展開
• 終了音/バイブ×3回: 終了音とバイブはそれぞれ3回繰り返して自動停止
• 休憩の手動開始: 集中終了後は自動で休憩に入らず、「休憩を開始」ボタンで手動スタート
• 瞑想の繰り返し回数: 瞑想詳細ページのカウントダウンを「繰り返し回数」に変更。1/2/3回ループ後に自動停止。無限ループとは排他
• 天気モードにトマト入口: 天気モード右上にトマトタイマーへのショートカットを追加

✨ 改善

• トマト設定の多言語化: 中国語/英語/日本語/韓国語/ロシア語/繁体中国語に対応
• バイブ実装の最適化: システム Vibrator を直接使用し VIBRATE 権限を追加、信頼性を向上
• バージョンアップ: 2.2.9 → 2.3.0

🆕 最新アップデート (v2.2.6)

🎨 新機能

• Bilibili ラジオ: Bilibili ライブ配信ルーム機能を追加。自習室、ホワイトノイズなどのカテゴリを検索可能
• ピン留め: よく使うルームをピン留めして素早く切替、配信していないルームはグレー表示

✨ 改善

• 編集モード最適化: ボトムシートを閉じる際にピン編集モードを自動的に解除
• プリセットダイアログ改善: プリセット名編集後にダイアログを閉じる際に編集状態をリセット

過去のバージョン

v2.2.3

• 一言ウィジェット: ホーム画面に時間、日替わり名言、更新ボタンを表示するウィジェット追加

v2.2.1

• 呼吸エクササイズ: 呼吸ガイド機能を追加
• 画面常時表示: 画面点灯設定を最適化
• 天気マッピング: 天気とオーディオのマッピングを改善

🚀 ダウンロード

最新版は GitHub Releases からダウンロードできます。

📋 ビルド要件

• Android Studio: Ladybug | 2024.2.1 以上
• JDK: 17 以上
• Android SDK: API 33 以上
• Gradle: 8.0 以上

🔨 ビルド手順

1. リポジトリをクローン

   git clone https://github.com/Tosencen/XMSLEEP.git
   cd XMSLEEP
   

2. Gradle 設定

   • gradle.properties.example を gradle.properties にコピー
   • (任意) GitHub Token を設定

3. プロジェクトを開く

   • Android Studio で開く
   • Gradle 同期

4. 実行

   • デバイスを接続またはエミュレーター起動
   • 実行ボタンをクリック

📖 使い方

基本操作

1. 再生: サウンドカードをタップして再生、再タップで停止
2. 音量調整: カード右下の音量アイコンから個別調整
3. タイマー: 右下のタイマーボタンから自動停止時間を設定

画面操作

1. テーマ切替: 左上のテーマボタンでライト/ダーク切替
2. カスタム設定: 設定画面でテーマカラー、アニメーション等を調整
3. プリセット管理: サウンドカードタイトルから「プリセットに追加」
4. プリセット切替: 下部プリセットエリアで 3 つのプリセットを切替
5. お気に入り: サウンドカードタイトルから「お気に入り」追加
6. Bilibili ラジオ: ラジオページの検索ボタンから Bilibili ライブルームをカテゴリ検索、ピンアイコンでよく使うルームを保存

高度な機能

1. フローティングボタン: 再生中に表示、タップで再生リスト確認
2. 一括追加: フローティングボタン展開中にプリセットへ一括追加
3. スマート格納: スクロールやタブ切替時に自動格納

⚠️ サウンドソース

• 内蔵サウンド: オープンソースオーディオライブラリ
• オンラインサウンド: moodist プロジェクト (MIT)
• サードパーティ: 各ライセンスに準拠
  • Pixabay Content License: Pixabay
  • CC0: Creative Commons Zero

🔒 プライバシー

本アプリはお客様のプライバシー保護を重視しています。製品改善のため、匿名の利用統計（アクティブユーザー数、クラッシュレポートなど）を収集しますが、個人を特定できる情報は収集しません。

📄 ライセンス

このプロジェクトは MIT License の下で公開されています。

🤝 コントリビューション

Issue と Pull Request を歓迎します！

コントリビューションガイド

1. リポジトリを Fork
2. 機能ブランチを作成 (git checkout -b feature/AmazingFeature)
3. 変更をコミット (git commit -m 'Add some AmazingFeature')
4. ブランチにプッシュ (git push origin feature/AmazingFeature)
5. Pull Request を開く

👤 作成者

Tosencen

• GitHub: @Tosencen

🙏 謝辞

• moodist - オンラインオーディオリソース
• Material Design 3 - UI デザインガイドライン
• MaterialKolor - 動的カラースキーム

---