﻿ヨフカシ 説明書
========================================

―他アプリで止まらない＆同時再生できる音声作品プレイヤー―　バージョン 1.0.0


■ 1. インストール
----------------------------------------

このアプリは Google Play ではなく、APK ファイルから直接インストールします。

1. ダウンロードした zip を展開し、yofukashi-1.0.0.apk（体験版は yofukashi-trial-1.0.0.apk）をスマホにコピーします（USB ケーブル、Google ドライブなど、方法は問いません）。
2. スマホの「ファイル」アプリで APK をタップします。
3. 「この提供元のアプリを許可」を求められたら許可して、インストールします。
4. 初回起動時に、通知の許可を求められます。バックグラウンド再生中の通知に使うので、許可してください。

Xiaomi / POCO / Redmi をお使いの場合：インストールの途中で、セキュリティアプリの確認画面（スキャンや「インストールを続行しますか」）が出ることがあります。そのまま続行して問題ありません。確認ボタンは約10秒で時間切れになるので、出たらすぐに押してください。

体験版と製品版は別のアプリとして同時に入れられます。体験版のデータは製品版に引き継げます（8章）。


■ 2. はじめに
----------------------------------------

1. PIN を決める（あとで設定でも可）。起動時と、しばらく離れて戻ったときに聞かれます。
2. フォルダを追加し、使い方を選びます。
   - 見に行くだけ：ダウンロードして解凍したフォルダが大量に並んでいる場所、音声作品以外も混ざっている場所に向いています。「作品」タブがフォルダ表示になり、新しい順に並びます。聴きたいフォルダをタップするだけ。一度再生した作品だけが一覧に残ります。再生せずに一覧へ入れたいときは、フォルダを長押し→「ライブラリに追加」（中に作品が複数あれば全部入ります）。
   - 全部読み込む：音声作品だけを整理して入れている場所に向いています。中の作品がすべて一覧に入り、アプリを開くたびに自動で更新されます。
3. 一覧の作品を左へスワイプすると「削除」ボタンが出て、一覧から外せます（直後に出る「元に戻す」で取り消し可）。音声ファイルは消えず、★・しおりも残ります。フォルダ表示でその作品を開き直すと、一覧に戻ります。
4. 「作品」タブの右上のアイコンで、フォルダを追加／一覧表示とフォルダ表示の切り替え／再読み込みができます。

作品の決まり：音声ファイル（mp3 / m4a / aac / wav / flac / ogg / opus）が入っているフォルダが1作品になります。中が mp3・wav などに分かれていれば、分かれる前のフォルダが1作品です（同じ内容の形式違いは片方だけ読み込みます）。フォルダ内の画像（cover／jacket で始まる名前が優先）がジャケットになります。作品名は、作品詳細の ⋮ →「名前を変える」で付け直せます。

作品ID（設定 > ライブラリ）：RJ123456 ＞ 製品版 ＞ mp3 のような入れ子だと、音声が入っているフォルダ名をそのまま使うと「製品版」だらけになってしまいます。3つから選べます。

- 作品IDのフォルダ名（初期設定）：作品IDを含むフォルダの名前を使います。見つからないときは「自動でえらぶ」と同じです。
- 自動でえらぶ：作品ID（RJ・VJ・BJ など）を含むフォルダ名があればそれを使い、無ければ「製品版」「mp3」などの中身を表さない名前を避けて、上のフォルダ名を使います。
- 音声があるフォルダ名：音声ファイルが直接入っているフォルダの名前を、そのまま使います。

切り替えると「全部読み込む」フォルダの作品はその場で付け直されます。「見に行くだけ」のフォルダの作品は、次にそのフォルダを開いたときに付け直されます。自分で名前を変えた作品はそのままです。


■ 3. 再生画面
----------------------------------------

- 中央をタップ：再生／一時停止
- 左をダブルタップ：10秒戻る　右をダブルタップ：10秒進む（続けてタップすると 20秒、30秒…）
- 長押し：押している間だけ倍速（倍率は設定 > 操作）
- 下のボタン：前のトラック／次のトラック／速度と声の高さ／スリープタイマー／しおり／A-Bリピート／画面ロック／その他（シャッフル・リピート・左右入れ替え・本編の開始位置・シークバーに出すしおり）
- 画面ロック：画面全体が黒くなり、タッチが効かなくなります。2本指で約1秒長押しで解除。
- 右上の赤い電源ボタン：クイック終了（6章）
- 一番下の「音を重ねる」：同時再生（5章）

作品詳細の「続きから」は前回の位置から、「本編から」は登録した本編の開始位置から再生します。


■ 4. しおり・A-Bリピート・お任せ再生
----------------------------------------

- しおり：再生画面のしおりボタン → 種類をタップ。シークバーの上に色の点で表示されます。ライブラリの「しおり」タブ（全作品）と作品詳細（その作品）に一覧があり、タップでその位置から再生、鉛筆で名前・メモ・種類を編集できます。種類の名前と色は「しおり」タブ右上から変更できます。
- A-Bリピート：A点・B点を指定して繰り返します。回数（無限／2／3／5／10回）を選べ、名前を付けて保存できます。しおり2つから区間を作ることもできます。
- お任せ再生：「しおり」タブの上のボタン。お任せ対象の種類（初期設定は「好きな声」「盛り上がり」）のしおりと、保存した区間から、ランダムに1つ再生します。


■ 5. 同時再生（レイヤー）とミックス
----------------------------------------

再生画面の一番下「音を重ねる」→「レイヤーを追加」で、音を重ねられます。選ぶ画面はフォルダを見に行く表示で開くので、一覧に入れていないフォルダからもそのまま選べます。上のタブで「一覧から」に切り替えると、作品・トラック・プレイリスト・環境音から選べます。
雨音などの作品は、作品詳細の ⋮ →「環境音として扱う」にしておくと、「一覧から」の先頭に出ます（普段の一覧からは外れ、「環境音」で絞り込むと出ます）。

- 再生中に長押しで重ねる：再生したまま別のフォルダや作品を見に行き、その行を長押しすると、再生を止めずに新しいレイヤーとして重なります（フォルダ表示では、長押しで出るメニューの「レイヤーに重ねる」）。
- レイヤーごとに、音量・左右の定位・左右の入れ替え・ループ・ミュートを調整できます。どれも押した／動かした瞬間に音へ反映され、再生は途切れません。
- レイヤーごとのプレーヤー：各レイヤーの「▾」を開くと、そのレイヤーだけのシークバー・−10秒／＋10秒・前へ／次へが出ます。ほかのレイヤーの再生位置は動きません。
- レイヤーの中の再生順：「▾」の中の一覧が、そのレイヤーで流れる順番です。曲名をタップするとそこへ移り、↑↓で並べ替え、×で外せます。「このレイヤーの最後に足す」で音源を足せるので、「レイヤー2は、音声1が終わったら音声2」という流し方ができます。ループがオンなら、最後まで行くと先頭へ戻ります。
- しおり・A-B・通知はメインのレイヤーが対象です。一時停止は全レイヤー同時。メインは ⋮ →「メインにする」で入れ替えられます。
- 「ミックスとして保存」で、組み合わせ（再生順・左右の入れ替えも含む）に名前を付けて保存。ライブラリの「ミックス」タブから呼び出せます。
- 8レイヤーを超えると、電池と音量についての注意が表示されます。


■ 6. 人に知られないための機能（設定 > プライバシー）
----------------------------------------

- アイコンと名前の偽装：ホーム画面のアイコンと名前を「ツール」「メモ」「計算機」に変えられます。偽装したアイコンから開いても、最初に PIN／指紋の画面が出ます。切り替え後、ホーム画面のアイコンが消えた場合は、アプリ一覧から置き直してください。
- 指紋で解除／控えめ表示モード（通知・ロック画面・Bluetooth 機器には「再生中」とだけ表示）／プレビュー隠し（「最近のアプリ」に中身を出さない。スクリーンショットも撮れなくなります）／ジャケットの見せ方（ぼかす・出さない）／履歴を残さないモード
- クイック終了：再生停止・通知の消去・アプリのロック・画面を閉じる、を一度に行います。再生画面とライブラリの右上の赤い電源ボタン、端末を振る（設定でオン。1秒以内に強く2回）、クイック設定タイル「すぐ閉じる」、ホーム画面ウィジェット「コントロール」から使えます。


■ 7. そのほかの設定
----------------------------------------

- 再生：他のアプリと同時に鳴らす（干渉回避モード）／着信・通話中は一時停止／再生中はサイレントモード
- 音量と安全：音量そろえ（作品ごとの微調整は作品詳細の ⋮ →「音量を補正」）／リミッター／アプリ内の最大音量／イコライザー・低音強調
- 睡眠：フェードアウトの長さ／巻き戻して記録／再生のたびに自動でタイマー／余韻モード
- 外観：黒フィルター／夜モード／左利き用の配置／再生画面の画像／既定の好きな画像
- ライブラリ：フォルダごとの読み込み方の切り替え／フォルダを追加／作品ID（2章）／トラック名に拡張子を出す（MP3・WAV などを曲名のうしろに小さく表示）
- PC接続（製品版）：「PCの共有フォルダを追加」→ PC の IP アドレス（「探す」で検索可）・ユーザー名・パスワードを入れて接続 → 共有フォルダを選ぶ → 作品のあるフォルダまで進んで登録。ユーザー名とパスワードは、PC（Windows）にサインインするときのものです（Microsoft アカウントならメールアドレス）。PC 側では、フォルダを右クリック →「プロパティ」→「共有」で共有しておいてください。


■ 8. データの引き継ぎ（体験版 → 製品版、機種変更）
----------------------------------------

1. 元のアプリ：設定 > データの引き継ぎ >「データを書き出す」でファイルを保存。
2. 新しいアプリ：「データを読み込む」でそのファイルを選ぶ。
3. 「フォルダを追加」で、元と同じフォルダをもう一度選ぶ（アクセスの許可のため）。

★・タグ・好きな画像・しおり・保存した区間・プレイリスト・続きの位置が引き継がれます。PIN、PC 接続の設定、音声ファイルそのものは含まれません。


■ 9. 困ったとき
----------------------------------------

・他のアプリで動画を再生すると、どちらかが止まる
    → 設定 > 再生 >「他のアプリと同時に鳴らす（干渉回避モード）」をオンにする（Xiaomi / POCO / Redmi などで起こります）。
・画面を消してしばらくすると再生が止まる
    → 端末の設定 > アプリ > このアプリ > 電池（バッテリーセーバー）を「制限なし」にする。
・イコライザーが効かない
    → 端末の機能を使っているため、機種によっては効きません。
・PC に接続できない
    → PC とスマホが同じ Wi-Fi か／PC のネットワークが「プライベート」になっているか／ユーザー名（Microsoft アカウントならメールアドレス）とパスワード／Windows アカウントにパスワードが設定されているか、を確認してください。
・PC 上の作品がグレーになっている
    → PC の電源が入っていない、または Wi-Fi がつながっていません。つながると元に戻ります。
・PIN を忘れた
    → アプリのデータを消去（端末の設定 > アプリ > ストレージ）すると初期状態に戻ります。★やしおりも消えるので、ふだんから「データを書き出す」で控えを取っておくことをおすすめします。


■ 10. このアプリが行う通信について
----------------------------------------

このアプリがネットワークを使うのは、あなたが登録した PC の共有フォルダとの通信（と、「探す」を押したときの同じ Wi-Fi 内の検索）だけです。広告・利用状況の送信・更新の確認など、インターネットへの通信は一切行いません。PIN と PC のパスワードは、端末の中に暗号化して保存されます。


■ 11. ライセンス
----------------------------------------

このアプリは以下のオープンソースソフトウェアを利用しています。
AndroidX / Jetpack Compose / Media3 / Room / DataStore / Hilt（Apache License 2.0）、Dagger（Apache 2.0）、Kotlin・kotlinx.coroutines（Apache 2.0）、Coil（Apache 2.0）、Reorderable（Apache 2.0）、smbj（Apache 2.0）、smbj-rpc（BSD 3-Clause、Copyright Rapid7, Inc.）、Bouncy Castle（Bouncy Castle Licence）、SLF4J（MIT）、MBassador（MIT）、asn-one（Apache 2.0）


■ お問い合わせ
----------------------------------------

かんら_AI Illust（X / Twitter：@Kanra_AIIllust）

不具合のご報告の際は、端末の機種名・Android のバージョン・起きたことを添えていただけると助かります。
