阿拉伯語軟體教學影片 (Arabic Software Training Video)

阿拉伯語軟體使用教學影片

將現有應用程式的介面和文件轉換為可供審閱和編輯的實用操作指南。每一項操作說明都必須指向真實的介面元素。每一項品質聲明都必須有實際的檢查作為依據。

建立範圍與參考資料

• 在選擇製作風格之前，先閱讀使用者的請求與附件。確認語言或方言、品牌標示、交付項目，以及顯示資料的限制。
• 檢查先前的影片、原始旁白、字幕和時間軸（如果有的話）。區分已核准的原始腳本和從音訊推斷出的逐字稿。
• 將目前的應用程式視為功能、欄位名稱、按鈕和路由的權威來源。使用提供的圖片和官方範本作為視覺參考。
• 如果已有可編輯的製作專案，請重複使用，而非不必要地重新擷取正確的素材。
• 對於機構性的阿拉伯語素材，預設使用現代標準阿拉伯語（MSA）。若有明確要求使用其他方言，則應予以尊重；在同一個版本中不要混用不同的風格。
• 影片製作請求並不授權更改應用程式程式碼、權限、網路或生產資料，也不授權發布或將素材寄送給其他人。

選擇可用的工具

使用實際可用的工具。不要假設存在語音服務、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。記錄每個步驟：

• 章節、步驟標題、旁白腳本與所需的擷取畫面。
• 要突出的元素，以及此動作是說明螢幕截圖還是記錄真實操作。
• 支援該說明的證據、任何等待時間，以及在適用的情況下的實際結果。

撰寫每次只解釋一個動作的簡短句子。保留介面標籤的顯示文字。不要為了填滿時間而讀出每個可見的單字，也不要為了縮短影片而省略必要的解說。

對有歧義的字詞（尤其是產品名稱、組織名稱和技術術語）套用部分阿拉伯語變音符號（diacritics）。維護一份可編輯的發音詞典。僅靠文字上的變音符號並不能證明生成的語音發音正確。

擷取介面並保護資料

1. 以支援可讀縮放的解析度擷取真實介面。使用適當的裝置畫素比（device pixel ratio），而非 AI 放大。
2. 將目標元素矩形和裁切偏移量與擷取畫面一同儲存，同時記錄檢視區尺寸和裝置畫素比。
3. 審閱標籤、數值、工具提示、連結以及可見的帳戶資訊，而不僅僅是已填寫的輸入欄位。
4. 使用訓練環境或在預覽中記錄遮罩。不要為了建立安全的螢幕截圖而更改生產資料。
5. 將替代的資訊標示為範例。可使用 example.org 和 192.0.2.10 來取代實際的操作連結和地址。
6. 在靜態螢幕截圖上移動指標或進行縮放是圖解說明，而非即時錄影。請準確描述。
7. 若要擷取真實的成功儲存畫面，請使用授權的隔離測試環境，並先確認寫入目標。之後清理測試記錄。若無法進行，請解釋程序，切勿偽造成功訊息。

不要將應用程式螢幕截圖或資料發送給旁白提供者。只發送一般的說明文字，並遵守使用者關於外部處理的限制。

旁白與阿拉伯語字幕

• 確認語音可用性，並測試一段具有代表性的文字。僅憑區域性的語音識別碼並不足以確定其方言、正式阿拉伯語或自然的表達方式。
• 保留每個片段的已核准文字、音訊和詞邊界。只重新生成有變更的片段。
• 音訊快取金鑰應基於文字、語音、語速和發音設定衍生；僅憑檔案存在與否並非有效的快取金鑰。
• 根據已核准的腳本建立 SRT，保留標點符號，並將其文字與時間邊界對齊。不要組合原始轉錄的標記（tokens）而遺失標點符號。
• 在無法進行精確對齊的情況下，應記錄預估時間。不要將其描述為基於聽力的精確驗證。
• 檢查阿拉伯語的渲染效果。優先使用 RAQM 的原生字型塑造功能；僅在必要時使用 reshaper/bidi。不要對文字進行兩次塑造或反轉。
• 使用包含阿拉伯文、數字和混合技術文字的字型進行測試。避免使用不完整的字型子集。
• 將字幕放置在重要操作區域之外。確保在手機尺寸下仍可閱讀，並儘量維持在一到兩行內。

動態與品牌標示

• 從實際專案中提取顏色、字型和標誌。使用原始標誌，不要重繪或重新著色。
• 清楚顯示當前的操作說明，而不是將所有說明集中在一個小螢幕截圖周圍。
• 在保持長寬比和整個相關欄位或按鈕可見的前提下，逐步放大到操作區域。
• 使用清晰的指標、緩動的移動軌跡，並在必要時提供簡短的點擊指示。點擊指示應與對應的旁白說明同步。
• 保持轉場效果平穩。避免抖動、閃爍和無意義的重複縮放。
• 當需要片頭和片尾時，使用相同的品牌識別，並逐步顯示標誌、組織和標題。8-12 秒等時長僅為範例，非通用要求。
• 不要將建議的標語呈現為官方核准的口號。

箭頭：顏色、位置與動態

以下是建議的製作預設值，並非聲明適用於所有現有影片。請根據應用程式的密度和使用者的參考資料進行調整，同時在整個交付項目中保持一致的註釋風格。

外觀

• 使用紅色 #D52424 作為教學箭頭，並加上白色 #FFFFFF 外框，使其在淺色和深色介面中都能區分開來。保持應用程式本身的顏色和標誌不變。
• 在 1920×1080 解析度下，起始設定為 5 px 箭桿、2 px 白色外框、18 px 箭頭，總長度約 90-160 px。根據輸出解析度按比例縮放這些數值，並檢查在手機尺寸下的可讀性。
• 可選用一個小的黑色陰影，不透明度約 18%，模糊半徑 3 px。不要添加霓虹光暈、厚重的 3D 效果、表情符號或文字箭頭字形。將註釋繪製為清晰的向量路徑或高解析度的透明圖層。
• 區分教學箭頭與實際滑鼠指標：箭頭用於解釋目標；指標用於指示導航或實際點擊。當兩者都會遮擋同一個控制項時，避免同時顯示。

放置與座標

• 指向實際按鈕、欄位或連結的邊緣，在 Full HD 解析度下保留約 6-12 px 的間距。不要遮蓋其標籤、輸入值、圖示、焦點外框、驗證訊息或字幕。
• 偏好從附近空白區域以對角線或短曲線路徑引入。每個操作只顯示一個教學箭頭。對於多個操作，應依序顯示箭頭，而非一次性全部留在畫面上。
• 儲存相對於來源擷取畫面的目標矩形和錨點。對箭頭尖端套用與螢幕截圖相同的裁切、縮放、平移和縮放變換。切勿對移動的縮放畫面硬編碼固定的螢幕座標。
• 在進行額外的縮放/平移之前，簡單的裁切-縮放對應關係為 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 秒內將箭頭淡出。在減少動態效果的版本中，用靜態箭頭和輕柔的淡入淡出來取代移動/縮放；避免脈衝或閃爍。

將顏色、尺寸、來源矩形、錨點、路徑、提示、進入持續時間、停留時間和退出持續時間儲存在可編輯的故事板/渲染設定中。在開始時、縮放期間、提示出現時和結束時預覽箭頭。確認它始終正確附著於目標元素、在畫面內、在兩種主題下都可讀，且不會遮擋字幕或介面內容。

音訊與音樂

使用原創或經過適當授權的音樂，並保留其來源或生成方法。不要模仿特定的受版權保護的樂曲。

標準化旁白音量並防止削波。如果音樂伴隨著語音，應根據旁白訊號將音樂音量調低（ducking），而非假設固定的電平就已足夠。避免對乾淨的數位語音進行降噪處理，以免損壞子音。

將旁白、音樂和混音設定分開保存以便編輯。不要為了達到任意時長而加快語速；應調整場景以配合說明。

時間軸與編碼細節

• 使用 PCM/WAV 或樣本計數來測量音訊，而非 MP3 的估計時長。
• 根據實際編碼片段長度或按影格網格四捨五入的時長來建立最終時間軸。包含章節分隔符號和音訊的前導/結尾。
• 將 SRT 和章節邊界綁定到最終時間軸，而非累積了四捨五入誤差的早期時間軸。
• 檢查已安裝 FFmpeg 版本的選項。不要假設 filter_complex_script 存在；在適當時直接傳遞濾鏡圖形。
• 對於拒絕接受 .65 格式的濾鏡，應將小數時長寫為 0.65。
• 使用明確的路徑和結構化的子程序參數。不要從旁白或章節標題建構 shell 命令。
• 當圖片、目標矩形、字型、標誌或佈局代碼發生變更時，應使渲染快取失效。
• 匯出獨立章節時，檢查關鍵影格邊界和音訊起始點。驗證提取的檔案本身。

品質審查與真實的核准

執行適合素材的檢查：

• 解碼完整的影片/音訊，檢查解析度、影格率、時長和音軌。
• 測量響度和峰值電平；檢查是否存在間隙和削波。
• 將字幕與已核准的腳本進行比較，並驗證時間軸順序和最終邊界。
• 檢查最終渲染的實際影格，包括片頭、片尾、縮放畫面、驗證訊息和成功狀態。
• 在瀏覽器或合適的播放器中測試播放和進度條拖曳，包括手機尺寸的預覽。
• 確認每個引用的元素都存在、焦點目標正確，且重要文字未被裁切。
• 驗證 PDF、XLSX、獨立片段和封存內容（如要求）。

自動轉錄不等於聆聽。 ASR 可能識別出需要審查的段落，但差異可能是辨識錯誤或拼寫差異。

分別記錄技術檢查、自動文字比對、文件化的聆聽過程以及正式核准。切勿標記聆聽或核准已完成，除非此事確實發生。

如果需要但無法進行直接或人工聆聽，請明確說明。交付支援的檔案和逐段聆聽審查記錄；不要聲稱發音完美無瑕。不要將基於 ASR 的變更報告為已確認的聆聽修正。

發音記錄應包含時間戳記、片段、已核准的文字、轉錄文字或標記字詞、要求的修正，以及聆聽/解決狀態。

交付

遵循請求的名稱和格式。完整的交付可能包含：

• 主要 MP4 以及獨立的片頭/片尾。
• 旁白 WAV、阿拉伯語 SRT 和章節時間戳。
• 發音審查 XLSX 和品質報告 PDF，顯示已驗證和待處理的項目。
• 故事板、安全截圖、字型/授權、音訊資產、編輯程式碼和依賴項資訊。
• 有用的獨立章節片段。

保持編輯專案的可攜帶性；排除開發者機器路徑和登入憑證。在建立壓縮檔之前檢查套件內容。僅連結實際存在的檔案，並陳述素材的限制，不聲稱未執行的工作。