Arabic-software-training-video / アラビア語ソフトウェアトレーニング動画

アラビア語ソフトウェアユーザーガイド動画

既存のアプリケーションインターフェースとドキュメントを、レビューおよび編集可能な実践的なウォークスルーに変換します。すべての指示は実際のインターフェース要素を参照しなければなりません。品質に関する主張はすべて、実際のチェックによって裏付けられなければなりません。

スコープとリファレンスの確立

• 制作スタイルを選択する前に、ユーザーのリクエストと添付ファイルを読みます。言語または方言、ブランディング、成果物、およびデータ表示の制限を特定します。
• 前回の動画、ソースナレーション、キャプション、およびタイミングが利用可能な場合はそれらを確認します。承認されたソーススクリプトと、音声から推測されたトランスクリプトを区別します。
• 現在のアプリケーションを、機能、フィールド名、ボタン、ルートに関する権威ある情報源として扱います。提供された画像と公式テンプレートを視覚的なリファレンスとして使用します。
• 不要な正しい素材を再キャプチャする代わりに、編集可能な制作プロジェクトが利用可能であればそれを再利用します。
• 現代標準アラビア語が、機関向けアラビア語資料のデフォルトです。別の方言を明示的に要求された場合はそれを尊重し、同じバージョン内でスタイルを混在させないでください。
• 動画制作のリクエストは、アプリケーションコード、パーミッション、ネットワーク、またはプロダクションデータの変更、公開、または他の人への素材送信を許可するものではありません。

利用可能なツールの選択

実際に利用可能なツールを使用してください。音声サービス、APIキー、またはGPUが存在することを前提としないでください。

ツール	目的
Pythonと仮想環境	制作パイプラインの整理と実行
Playwright + Chromium	実際のインターフェースのキャプチャと再生テスト
Pillow	フレーム、タイトル、レイヤー、ポインター、フォーカス位置
NumPy	音声処理またはオリジナルの手続き型音楽
FFmpeg（ローカルまたはimageio-ffmpeg経由）	モーション、合成、エンコード、音声処理
edge-ttsまたは許可されたプロバイダー	ナレーションとワードバウンダリータイミング
arabic-reshaperとpython-bidi	RAQMが利用できない場合のアラビア語整形フォールバック
PyAV	メディアの長さ、フレーム数、クリップチェック
faster-whisper	リソースが許す場合のレビュー用オプションのローカル文字起こし
openpyxl	発音とレビューレコード
HTML/Chromiumまたは適切なPDFツール	読みやすいアラビア語品質レポート

依存関係をインストールする前に、Python/パッケージの互換性を確認してください。分離された環境を使用し、バージョンを記録してください。フォントは公式ソースから入手し、ライセンスを保管してください。

編集可能なストーリーボードの作成

storyboard.jsonなどの構造化データを使用します。各ステップについて以下を記録します。

• チャプター、ステップタイトル、発話スクリプト、必要なキャプチャ。
• ハイライトする要素と、モーションがスクリーンショットを説明するものか、実際のアクションを記録するものか。
• 指示を裏付ける証拠、待機時間、該当する場合は実際の結果。

一度に1つのアクションを説明する短い文を書いてください。インターフェースラベルは表示されたままにしてください。時間を埋めるためにすべての表示テキストを読んだり、動画を短くするために必要な説明を省略したりしないでください。

曖昧な単語、特に製品名、組織名、技術用語には、部分的なアラビア語ディアクリティクスを適用します。編集可能な発音辞書を維持します。テキストのディアクリティクスだけでは、生成された音声が正しく発音されていることを証明できません。

インターフェースのキャプチャとデータの保護

1. 読み取り可能なズームをサポートする解像度で実際のインターフェースをキャプチャします。AIアップスケーリングではなく、適切なデバイスピクセル比を使用してください。
2. ターゲット要素の矩形とクロップオフセットを、ビューポート寸法およびデバイスピクセル比と一緒にキャプチャと共に保存します。
3. 入力フィールドだけでなく、ラベル、値、ツールチップ、リンク、表示可能なアカウントを確認します。
4. トレーニング環境またはプレビューでの文書化されたマスキングを使用します。安全なスクリーンショットを作成するためだけにプロダクションデータを変更しないでください。
5. 置き換えられた情報は例であるとラベル付けします。example.orgおよび192.0.2.10は運用リンクとアドレスを置き換えることができます。
6. 静止スクリーンショット上のポインタモーションまたはズームはイラストであり、ライブ録画ではありません。正確に説明してください。
7. 実際の成功した保存をキャプチャするには、許可された分離されたテスト環境を使用し、最初に書き込み先を確認します。テストレコードは後でクリーンアップします。利用できない場合は、成功メッセージを作成せずに手順を説明します。

アプリケーションのスクリーンショットやデータをナレーションプロバイダーに送信しないでください。一般的な説明テキストのみを送信し、ユーザーの外部処理に関する制限を尊重します。

ナレーションとアラビア語字幕

• 音声の可用性を確認し、代表的なパッセージをテストします。地域の音声識別子だけでは、方言、正式アラビア語、または自然な話し方が確立されません。
• 承認されたテキスト、音声、およびワードバウンダリーを各セグメントごとに保持します。変更されたセグメントのみを再生成します。
• オーディオキャッシュキーはテキスト、音声、レート、発音設定から導出します。ファイルの存在だけでは有効なキャッシュキーではありません。
• 承認されたスクリプトからSRTを構築し、句読点を保持し、単語をタイミング境界に合わせます。生のトランスクリプトトークンを組み立てて句読点を失わないでください。
• 正確なアライメントが利用できない場合は、推定タイミングを文書化します。正確なリスニングベースの検証として説明しないでください。
• アラビア語のレンダリングを確認します。RAQMによるネイティブ整形を優先し、必要な場合にのみリシェイパー/bidiを使用します。テキストを2回整形または反転しないでください。
• アラビア語、数字、および混合された技術テキストでフォントをテストします。不完全なフォントサブセットは避けてください。
• キャプションは重要なアクション領域の外側に配置します。電話サイズでも読みやすく、できれば1行または2行以内にします。

モーションとブランディング

• 実際のプロジェクトから色、フォント、ロゴを抽出します。オリジナルのロゴを再描画したり色を変更したりせずに使用します。
• 小さなスクリーンショットの周りにすべての指示を詰め込むのではなく、現在の指示を明確に表示します。
• アスペクト比と関連するフィールドまたはボタン全体を維持しながら、アクションに段階的にズームインします。
• 明確なポインター、イーズアウトされた動き、および必要に応じて簡潔なクリック表示を使用します。クリックを対応する音声指示に合わせます。
• トランジションは穏やかに保ちます。揺れ、フラッシュ、目的のない繰り返しズームは避けてください。
• イントロダクションとエンディングが要求された場合は、同じアイデンティティを使用し、ロゴ、組織、タイトルを段階的に表示します。8〜12秒などの時間は例であり、普遍的な要件ではありません。
• 提案されたタグラインを公式に承認されたスローガンとして提示しないでください。

矢印：色、配置、モーション

これらは推奨される制作デフォルトであり、既存のすべての動画に関する主張ではありません。アプリケーションの密度とユーザーのリファレンスに合わせて調整し、1つの成果物全体で一貫した注釈スタイルを維持してください。

外観

• 指示矢印には赤#D52424を使用し、明るいインターフェースと暗いインターフェースの両方から分離するために白#FFFFFFの輪郭線を付けます。アプリケーション独自の色とロゴは変更しないでください。
• 1920x1080では、5 pxのシャフト、2 pxの白い輪郭線、18 pxの矢じり、約90〜160 pxの全長から始めます。これらの値を出力解像度に比例してスケーリングし、電話サイズでの可読性を確認します。
• 約18％の不透明度と3 pxのぼかしを持つ小さな黒い影はオプションです。ネオングロー、重い3D効果、絵文字、またはテキスト矢印グリフを追加しないでください。注釈はクリーンなベクターパスまたは高解像度の透明レイヤーとして描画します。
• チュートリアル矢印と実際のマウスポインターを区別します。矢印はターゲットを説明し、ポインターはナビゲーションまたは実際のクリックを示します。両方が同じコントロールを隠す場合は、両方を表示しないでください。

配置と座標

• 実際のボタン、フィールド、またはリンクの端を指し、フルHDで約6〜12 pxのクリアランスを残します。ラベル、入力値、アイコン、フォーカスアウトライン、バリデーションメッセージ、またはキャプションを覆わないでください。
• 近くの空きスペースからの斜めまたは短い曲線パスを優先します。アクションごとに1つの指示矢印を表示します。複数のアクションの場合は、画面上にまとめて表示するのではなく、矢印を順次表示します。
• ターゲット矩形と、ソースキャプチャに対するアンカーを保存します。同じクロップ、スケーリング、パン、ズーム変換を矢印の先端にもスクリーンショットと同様に適用します。移動するズームに対して固定画面座標をハードコードしないでください。
• 追加のズーム/パン前の単純なクロップ・スケールマッピングは screenX = offsetX + scale * (sourceX - cropX)、Yも同様です。後続のアニメーション変換も適用し、実際のエンコードフレームを確認します。
• RTL/LTRは注釈テキストのレイアウトに影響しますが、実際のターゲット位置には影響しません。ナレーション言語が変更されたという理由だけで自動的に矢印をミラーリングしないでください。

タイミングと動き

1. 関連する画面が落ち着くのを待ちます。矢印を約0.15〜0.25秒かけてフェードインします。
2. 動きがアクションの説明に役立つ場合は、イーズモーションを使用して、約0.35〜0.65秒かけて先端をターゲットに向かって一度移動します。バウンス、シェイク、スピン、または連続的に動きを繰り返さないでください。
3. 便利なイージング関数は e = (1 - cos(pi * u)) / 2 です。ここで u は0〜1にクランプされた経過進行度です。p = start + (end - start) * e を使用して位置を補間します。曲線パスの場合は、イーズされた進行度で曲線を評価し、その接線に沿って矢じりを向けます。
4. ナレーターがターゲットを指名するか「クリックしてください」と言うときに動きを完了します。このキューはナレーションタイムラインまたはレビューされたワードバウンダリーから導出します。すべてのシーンに同じ任意の遅延を適用しないでください。
5. 視聴者がコントロールを読み、指示を聞いている間、矢印を静止させます。1〜2秒のホールドが出発点となりますが、実際の時間は音声指示とターゲットの可読性によって決まります。
6. クリックを描写する場合は、キューに同期して、ターゲットに約0.3〜0.5秒間の単一の微妙なリングを表示します。この注釈は、実際のアクションや成功した保存が発生しなかった場合に、それが発生したことを示唆してはなりません。
7. ターゲットまたはシーンを切り替える前に、約0.15〜0.25秒かけて矢印をフェードアウトします。モーション削減バージョンでは、移動/ズームを静止矢印と穏やかなフェードに置き換えます。パルスやフラッシュは避けてください。

色、寸法、ソース矩形、アンカー、パス、キュー、開始時間、ホールド、終了時間を編集可能なストーリーボード/レンダリング設定に保存します。開始時、ズーム中、キュー時、終了時に矢印をプレビューします。矢印が正しい要素に付着したまま、フレーム内に収まり、両方のテーマで読み取れ、キャプションやインターフェースコンテンツを隠していないことを確認します。

オーディオと音楽

オリジナルまたは適切にライセンスされた音楽を使用し、そのソースまたは生成方法を保持します。特定の保護された作品を模倣しないでください。

ナレーションをノーマライズし、クリッピングを防止します。音楽がスピーチに伴う場合は、固定レベルで十分だと想定せずに、ナレーション信号に従ってダッキングします。クリーンなデジタルスピーチにノイズリダクションを適用して子音を損なわないでください。

ナレーション、音楽、ミックス設定は編集のために分離しておきます。任意の時間に合わせるためにスピーチを高速化しないでください。説明に合わせてシーンを調整します。

タイミングとエンコードの詳細

• 推定MP3 durationではなく、PCM/WAVまたはサンプルカウントを使用してオーディオを測定します。
• 実際のエンコード済みクリップ長またはフレームグリッド丸め時間から最終タイムラインを構築します。チャプターセパレーターとオーディオリードイン/テールを含めます。
• SRTとチャプター境界を最終タイムラインにバインドします。累積的な丸めドリフトのある以前のタイムラインにはバインドしないでください。
• インストールされているFFmpegバージョンのオプションを確認します。filter_complex_scriptが存在することを前提とせず、適切な場合はフィルターグラフを直接渡します。
• 後者を拒否するフィルターのために、.65ではなく0.65などの10進数の時間を記述します。
• 明示的なパスと構造化されたサブプロセス引数を使用します。ナレーションやチャプタータイトルからシェルコマンドを構築しないでください。
• 画像、ターゲット矩形、フォント、ロゴ、またはレイアウトコードが変更された場合は、レンダリングキャッシュを無効にします。
• スタンドアロンチャプターをエクスポートする場合は、キーフレーム境界とオーディオ開始を確認します。抽出されたファイル自体を検証します。

品質レビューと真実の承認

素材に適したチェックを実行します。

• 完全なビデオ/オーディオをデコードし、解像度、フレームレート、時間、トラックを確認します。
• ラウドネスとピークレベルを測定します。ギャップとクリッピングをチェックします。
• キャプションを承認されたスクリプトと比較し、タイミング順序と最終的な境界を検証します。
• 実際の最終レンダリングからのフレームを検査します。これにはイントロダクション、エンディング、ズーム、バリデーションメッセージ、成功状態が含まれます。
• ブラウザまたは適切なプレーヤーでの再生とシークをテストします。電話サイズのプレビューも含めます。
• 参照された各要素が存在すること、フォーカスターゲットが正しいこと、重要なテキストが切り取られていないことを確認します。
• 要求された場合、PDF、XLSX、スタンドアロンクリップ、アーカイブコンテンツを検証します。

自動文字起こしはリスニングではありません。 ASRはレビューが必要なパッセージを特定する場合がありますが、不一致は認識エラーまたはスペルの違いである可能性があります。

技術的チェック、自動テキスト比較、文書化されたリスニング、公式承認を個別に記録します。リスニングまたは承認が行われなかった限り、完了としてマークしないでください。

必要な直接リスニングまたは人間によるリスニングが利用できない場合は、その旨を明確に述べます。サポートファイルとセグメントごとのリスニングレビューレコードを提供します。完璧な発音を主張しないでください。ASRベースの変更を確認されたリスニング修正として報告しないでください。

発音レコードには、タイムスタンプ、セグメント、承認テキスト、文字起こしまたはフラグされた単語、要求された修正、リスニング/解決ステータスを含める必要があります。

納品

要求された名前と形式に従います。完全な納品には以下が含まれる場合があります。

• メインMP4と別のイントロダクション/エンディング。
• ナレーションWAV、アラビア語SRT、チャプタータイムスタンプ。
• 発音レビューXLSXと品質レポートPDF（確認済みおよび未解決の項目を示す）。
• ストーリーボード、安全なキャプチャ、フォント/ライセンス、オーディオアセット、編集コード、依存関係情報。
• 必要に応じてスタンドアロンチャプタークリップ。

編集プロジェクトはポータブルに保ちます。開発者マシンのパスとログイン認証情報は除外します。アーカイブを作成する前にパッケージを検査します。存在するファイルのみをリンクし、実行していない作業を主張せずに素材の制限を明記します。