SoftPlayer ユーザーマニュアル

ターゲットマシンにSoftPlayerを解凍し、環境が要件を満たしていることを確認する。

1. ターゲットマシンがWindows 10/11 x64であることを確認します。
2. SoftPlayerパッケージを恒久的なディレクトリ（例：C:\SoftPlayer\）に解凍します。
3. ディレクトリにSoftPlayer.exe、appsettings.json、SoftPlayerMedia\サブディレクトリ構造が含まれていることを確認します。
4. 8K動画再生の場合、マシンにハードウェアデコード対応GPU（GTX 1060以上または同等品）が必要です。4K以下はオンボードグラフィックスでも動作します。

• 解凍したディレクトリにSoftPlayer.exeが表示されている。
• SoftPlayerMedia\ディレクトリが事前作成されており、サブディレクトリ（Video、StandBy、Audio、PPTなど）が存在する。

• SoftPlayerは安定したパスに配置してください — メディアファイル、ログ、ライセンス状態はすべてプログラムディレクトリを基準に保存されます。
• 高解像度再生をスムーズにするため、200MB/s以上の読み取り速度を持つSSDストレージを推奨します。

プログラムが正常に起動することを確認し、初回起動のオンボーディングを完了する。

1. SoftPlayer.exeをダブルクリックして起動します（管理者権限不要）。
2. 初回起動時、プログラムはデフォルトブラウザでクイックスタートガイドを開きます（初回のみ。以降の起動ではスキップ）。
3. ガイドを確認したら、ブラウザで http://localhost:8766/ にアクセスして管理コンソールを開きます。
4. ダッシュボードタブで、プレーヤーの状態が正常であること、バージョン/ライセンス情報が表示されていることを確認します。

• ブラウザが管理コンソール（http://localhost:8766/）を正常に開き、ダッシュボードが表示されている。
• コンソールヘッダーにバージョン番号とライセンス状態が表示されている。

初回起動ガイドを無効にするには、appsettings.jsonでSystem.ShowQuickStartOnFirstRunをfalseに設定してください。

UDP経由でプレーヤーを制御することに成功し、制御チャンネルが機能していることを確認する。

1. ビデオファイル（例：test.mp4）をSoftPlayerMedia\Video\ディレクトリに配置します。
2. PowerShellを開き、以下のコマンドを実行します：
3. $udp = New-Object System.Net.Sockets.UdpClient
4. $data = [System.Text.Encoding]::UTF8.GetBytes("video:test.mp4")
5. $udp.Send($data, $data.Length, "127.0.0.1", 7600)
6. $udp.Close()
7. SoftPlayerのウィンドウで指定したビデオの再生が開始されるか確認します。

• SoftPlayerのウィンドウで指定したビデオファイルの再生が始まる。
• 管理コンソールのログタブにコマンドが受信されたことが表示される。

• ビデオファイルが間違ったディレクトリに配置されている（プログラムルートではなく、SoftPlayerMedia\Video\に配置する必要があります）。
• ポートが間違っている（デフォルトは7600で、管理コンソールポートの8766ではありません）。

コマンド形式を習得し、成功と失敗の応答を理解する。

1. コマンド形式：コマンド:引数（例：video:show.mp4 または volume:80）。
2. 引数のないコマンドはコマンド名のみ送信できます（コロン任意）。例：play。
3. 成功応答の形式：OK:元のコマンド（例：OK:video:show.mp4）。
4. 失敗応答の形式：ERR:元のコマンド:エラーメッセージ。
5. メディアファイルパスにはファイル名のみ必要です — プレーヤーは対応するサブディレクトリを自動的に検索します：video:はSoftPlayerMedia/Video/を検索。

• コマンド送信後にOKプレフィックスの応答があれば、形式が正しく実行されたことを確認。
• ERR応答には具体的な理由が含まれます（ファイルが見つからない、形式エラーなど）。

サブディレクトリを指定するには、スラッシュを使用します：video:subfolder/video.mp4はSoftPlayerMedia/Video/subfolder/を検索します。

ビデオ再生関連のすべてのコマンドを習得する。

1. ローカルビデオを再生：video:filename.mp4（Videoディレクトリを検索）。
2. ネットワークビデオストリームを再生：webvideo:URL（HTTP/HTTPS/RTSP/RTMP/UDPストリームに対応）。
3. 再生/再開：play:（一時停止中のメディアを再開）。
4. 一時停止：pause:（現在のメディアを一時停止）。
5. 停止してスタンバイに戻る：stop:（ウェルカム画面/スタンバイループに戻る）。
6. 完全停止/黒画面：stoped:（省電力の黒画面）。
7. 現在のメディアをリプレイ：replay:。
8. 進行制御：seek:ミリ秒（位置にジャンプ）、forward:（10秒進む）、backward:（10秒戻る）。
9. 再生速度：speed:1.5（1.5倍速、2.0倍速などに対応）。

• video:コマンド後、プレーヤーが指定されたファイルの再生を開始する。
• stop:コマンド後、スタンバイ画面に戻る（スタンバイファイルが設定されている場合）。

• 展示の長時間スタンバイには、stoped:の黒画面ではなく、standby:でスタンバイファイルをループさせてください（黒画面はデバイスが壊れていると思われる可能性があります）。
• stopとstopedは意味が異なります：stopはウェルカム画面に戻り、stopedは純粋な黒画面を表示します。

音量調整とオーディオ再生制御コマンドを習得する。

1. 音量を設定（0-100）：volume:80（正確な値に設定）。
2. 音量を10%上げる：volup:（呼び出しごとに10%増加）。
3. 音量を10%下げる：voldown:（呼び出しごとに10%減少）。
4. ミュートの切り替え：mute:（ミュートとミュート解除を切り替え）。
5. 明示的にミュート：muteon:。
6. 明示的にミュート解除：muteoff:。
7. オーディオファイルを再生：audio:filename.mp3（SoftPlayerMedia/Audio/を検索）。
8. オーディオを停止：audiostoped:。

• volume:50の後、プレーヤーの音量が50%に下がる。
• mute:で音あり/なしが切り替わる。

ループリスト、PPTページ送り、Web読み込みコマンドを習得する。

1. プレイリストをループ：listloop:file1.mp4;file2.mp4;file3.mp4（セミコロンでファイルを区切る）。
2. 順次再生（最後で停止）：liststop:filename。
3. 次のトラック：next:、前のトラック：prev:。
4. フルスクリーンでPPTを開く：ppt:filename.pptx（SoftPlayerMedia/PPT/を検索）。
5. PPTナビゲーション：ppt:next（次のスライド）、ppt:prev（前へ）、ppt:home（最初）、ppt:end（最後）。
6. スライドにジャンプ：ppt:goto-5（5ページ目にジャンプ）。
7. PPTの自動送り：ppt:auto-5-filename.pptx（5秒ごとに自動送り）。
8. Webページを読み込む：web:URL（指定されたURLをフルスクリーンで表示）。

• listloop:コマンド後、プレーヤーがリストされたファイルを循環再生する。
• ppt:nextでPPTが次のスライドに進む。

• コマンドを送信する前に、PPTファイルをSoftPlayerMedia/PPT/に配置する必要があります。
• PDFファイルの場合、コマンドはシミュレートされたキー押下によるページングを持つビューアウィンドウにフォールバックします。
• 展示のループシナリオには、個別のコマンドを手動で送信するのではなく、listloopを使用してください。

マスクとシステムレベルのコマンドを理解する。

1. マスクオーバーレイを表示：openmask:（ビデオ上にマスクレイヤーをオーバーレイ）。
2. マスクオーバーレイを非表示：closemask:。
3. 再生終了時の動作を設定：endbehavior:Stop / Loop / Standby。
4. バージョンを取得：version:（現在のバージョン情報を含む応答）。
5. プレーヤーを再起動：restart:（プレーヤープロセスをリモートで再起動）。

• openmask:の後、ビデオ上にマスクオーバーレイが表示される。
• version:の後、バージョン情報を含む応答が受信される。

各種メディアファイルの正しい配置場所を把握する。

1. SoftPlayerMedia/Video/ — 動画ファイル（.mp4/.mkv/.aviなど）、video:コマンドで使用。
2. SoftPlayerMedia/StandBy/ — スタンバイファイル、standby:コマンドとデフォルトループで使用。
3. SoftPlayerMedia/Audio/ — 音声ファイル（.mp3/.wav/.flacなど）、audio:コマンドで使用。
4. SoftPlayerMedia/BackgroundAudio/ — バックグラウンドオーディオ、有効時に自動ループ。
5. SoftPlayerMedia/PPT/ — PPT/PDFファイル、ppt:コマンドで使用。
6. SoftPlayerMedia/Mask/ — マスク画像、openmask:コマンドで使用。
7. SoftPlayerMedia/Thumbnail/ — サムネイルキャッシュディレクトリ（自動生成、手動ファイル不要）。

• Video/に動画を配置した後、video:filenameコマンドで正常に再生される。
• ディレクトリ構造は初回起動時に自動作成されます — 手動セットアップは不要。

ブラウザ管理コンソールで日常的なメディアファイル管理を行う。

1. ブラウザで http://プレーヤーIP:8766/ を開いて管理コンソールにアクセスします。
2. 上部ナビゲーションをクリックして「ファイル」タブに切り替えます。
3. ターゲットディレクトリを選択します（Video / StandBy / Audio / PPTなど）。
4. 「アップロード」をクリックしてファイルを選択するか、アップロードエリアにファイルをドラッグします。
5. フォルダの作成、名前変更、ファイル/フォルダの削除、ファイルのダウンロードに対応。
6. ファイルは最大3レベルのサブディレクトリをサポートします。アップロード時に現在のディレクトリを選択してください。

• アップロード後、新しいファイルがファイルリストに表示される。
• video:filenameコマンドで、アップロードしたばかりのファイルが正常に再生される。

• コンソールはBasic Authを使用します — appsettings.jsonでユーザー名/パスワードを設定してください。
• デフォルトのシングルファイルアップロード制限は500MBで、設定ファイルで変更可能。
• 現場のメンテナンス担当者はRDPなしでコンソール経由でコンテンツを更新できます。

トライアルのルールを理解し、適切なライセンスタイミングを計画する。

1. 30日間のトライアルはSoftPlayerの初回実行時に自動的に開始されます。
2. トライアル中は高解像度再生とすべてのUDPコマンドを含む、すべての機能が利用可能です。
3. 管理コンソールのダッシュボードタブで残りのトライアル日数を確認できます。
4. トライアル終了後は、継続使用するためにライセンスコードをインポートする必要があります。

• 管理コンソールのダッシュボードに現在のトライアル状態と残日数が表示される。
• トライアル中はコマンドが正常に応答し、機能制限がない。

• 正式なプロジェクト納品前に、トライアル期間を活用してテストと検収を完了させてください。
• 展示のダウンタイムを避けるため、トライアルが終了する前にライセンスを購入してください。

実際の展示解像度ニーズに基づいて適切なライセンスティアを選択する。

1. スタンダードライセンス：最大4K解像度（3840×2160）をサポート。
2. プロフェッショナルライセンス：最大16K解像度（15360×8640）をサポート。
3. 4Kのハードウェア要件：Intel i3以上、8GB RAM、オンボードグラフィックス（独立GPUは不要）。
4. 8Kのハードウェア要件：Intel i5 8世代以上、16GB RAM、GTX 1060以上。
5. 16Kのハードウェア要件：Intel i7以上、32GB RAM、RTX 3070以上。
6. どのティアが必要かわからない場合は、購入前にトライアルで実際の解像度要件を確認してください。

• ライセンスティアがプロジェクト内のディスプレイデバイスの最大解像度と一致している。
• サーバーのハードウェア構成がターゲット解像度の最小要件を満たしている。

独立GPUのないコンピューターでは4K以下を再生できます（プログラムが自動的にソフトウェアデコードにフォールバック）が、8K/16Kには対応した独立GPUが必要です。

ライセンスコードをインポートして、トライアルから正式版にアップグレードする。

1. 管理コンソールのダッシュボードでデバイスIDフィールドを見つけてコピーします。
2. デバイスIDをサプライヤーに提供し、必要なティア（スタンダード/プロフェッショナル）を指定します。
3. ライセンスコードを受け取ったら、コンソールの「設定」タブに移動し、ライセンス管理セクションを見つけます。
4. ライセンスコードを入力フィールドに貼り付けて「ライセンスをインポート」をクリックします。
5. インポート成功後、ダッシュボードのライセンス状態がトライアルからスタンダードまたはプロフェッショナルに変わります。

• 管理コンソールのダッシュボードに正式版状態（スタンダードまたはプロフェッショナル）が表示される。
• 高解像度ビデオ再生が制限されなくなった。

• 間違ったデバイスにライセンスコードを適用する（コードはデバイスに紐付けられており、新しいマシンには新しいコードが必要）。
• トライアルの有効期限が切れてからライセンスを申請し、展示のダウンタイムを引き起こす。

UDPコマンド制御チャンネルを復旧する。

1. SoftPlayerが実行中であることを確認します（タスクバーまたはタスクマネージャーで確認）。
2. コマンドのポートがappsettings.jsonのUdpPort設定（デフォルト7600）と一致していることを確認します。
3. WindowsファイアウォールがUDPポート7600への着信トラフィックを許可しているかどうかを確認します。
4. IPホワイトリストが有効な場合（IpWhitelistEnabled: true）、送信元IPがAllowedIpsに含まれていることを確認します。
5. 管理コンソールのログタブでコマンド受信記録を確認し、コマンドがプレーヤーに届いているかを確認します。

• 管理コンソールのログにコマンド受信記録が表示され、UDPチャンネルが機能していることを確認。
• volume:50を送信してプレーヤーの音量が変わる。

• 実際のIPを使用する前に、127.0.0.1（ローカルホスト）でテストしてネットワークの問題を除外してください。
• SoftControlから送信する場合、SoftControlのUDPコマンドプロトコルとポートがSoftPlayerの設定と一致していることを確認してください。

メディアファイル再生失敗の診断と解決。

1. ビデオファイルがSoftPlayerMedia\Video\（プログラムルートディレクトリではなく）にあることを確認します。
2. ファイル名は大文字小文字を区別します — コマンドの名前が拡張子を含む実際のファイル名と完全に一致することを確認します。
3. サブディレクトリ内のファイルは、相対パスを含めてください：video:subfolder/video.mp4。
4. 管理コンソールのファイルタブでファイルが実際に存在することを確認します。
5. 特殊なファイル形式の場合、管理コンソールのログでVLCエラーメッセージを確認します。
6. 同じマシンでVLC Playerで直接ファイルを開いて、ファイルの破損を除外してみてください。

• ターゲットファイルが管理コンソールのファイルリストに表示されている。
• コマンドのファイル名がファイルリストに表示されているものと完全に一致している。

• コマンドのファイル名に全角スペースや文字が含まれており、ファイルが見つからない。
• ファイル拡張子の大文字小文字が一致しない（例：コマンドで.MP4を使用しているが、実際のファイルは.mp4）。

高解像度ビデオ再生のパフォーマンス問題を解決する。

1. まず現在のライセンスティアを確認します：スタンダードは最大4Kのみ、プロフェッショナルは16Kをサポート。
2. GPUがハードウェアデコードをサポートしているかどうかを確認します（8KにはGTX 1060以上または同等品が必要）。
3. タスクマネージャーのパフォーマンスタブでGPUデコード使用率を確認します — 100%に近い場合はGPUボトルネックを示します。
4. ディスク読み取り速度の要件を確認します：4Kは25〜50 Mbps、8Kは80〜100 Mbps、16Kは200+ Mbps。
5. HDDの読み取りボトルネックを避けるため、高解像度ビデオファイルをSSDに保存してください。
6. VLCパラメータ調整については、プログラムディレクトリの組み込みドキュメント（docs\User Manual.html）を参照してください。

• ライセンスティアが必要な再生解像度と一致している。
• ハードウェア構成がターゲット解像度の最小要件を満たしている。

ブラウザ管理コンソールへのアクセスを復旧する。

1. SoftPlayerが実行中であることを確認します。
2. まずローカルで http://localhost:8766/ を試してネットワークの問題を除外します。
3. appsettings.jsonを確認してHttpMonitor.Enabledがtrueで、ポートが8766であることを確認します。
4. WindowsファイアウォールがTCPポート8766への通信を許可しているかどうかを確認します。
5. 他のプログラムによってポートが占有されている場合、appsettings.jsonのHttpMonitor.Portを変更して再起動してください。

• ブラウザで http://localhost:8766/ にアクセスでき、管理コンソールが表示される。
• 管理コンソールのダッシュボードにプレーヤーの実行状態が表示される。