arabic-software-training-video

아랍어 소프트웨어 사용자 가이드 비디오

기존 애플리케이션의 인터페이스와 문서를 검토하고 편집할 수 있는 실용적인 워크스루로 전환합니다. 모든 명령은 실제 인터페이스 요소를 참조해야 합니다. 모든 품질 주장은 실제 확인을 기반으로 해야 합니다.

범위 및 참조 설정

• 제작 스타일을 선택하기 전에 사용자의 요청과 첨부 파일을 읽습니다. 언어 또는 방언, 브랜딩, 인도물, 데이터 표시 제한을 식별합니다.
• 가능한 경우 이전 비디오, 소스 내레이션, 자막 및 타이밍을 검사합니다. 승인된 소스 스크립트를 오디오에서 추론된 대본과 구분합니다.
• 현재 애플리케이션을 기능, 필드 이름, 버튼 및 경로에 대한 권위자로 취급합니다. 제공된 이미지와 공식 템플릿을 시각적 참조로 사용합니다.
• 가능한 경우 불필요하게 올바른 자료를 다시 캡처하는 대신 편집 가능한 프로덕션 프로젝트를 재사용합니다.
• 현대 표준 아랍어(Modern Standard Arabic)는 기관 아랍어 자료의 기본값입니다. 다른 방언에 대한 명시적 요청은 존중하십시오. 동일한 버전 내에서 스타일을 혼합하지 마십시오.
• 비디오 제작 요청은 애플리케이션 코드, 권한, 네트워크 또는 프로덕션 데이터 변경, 게시 또는 다른 사람에게 자료 전송을 승인하지 않습니다.

사용 가능한 도구 선택

실제로 사용 가능한 도구를 사용하십시오. 음성 서비스, 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. 읽기 쉬운 확대/축소를 지원하는 해상도로 실제 인터페이스를 캡처합니다. AI 업스케일링 대신 적절한 장치 픽셀 비율을 사용하십시오.
2. 캡처와 함께 대상 요소 사각형 및 자르기 오프셋, 뷰포트 크기 및 장치 픽셀 비율을 저장합니다.
3. 채워진 입력 필드뿐만 아니라 레이블, 값, 도구 설명, 링크 및 표시되는 계정을 검토합니다.
4. 미리보기에는 교육 환경 또는 문서화된 마스킹을 사용하십시오. 안전한 스크린샷을 만들기 위해 프로덕션 데이터를 변경하지 마십시오.
5. 대체된 정보는 예시로 표시하십시오. example.org 및 192.0.2.10은 운영 링크 및 주소를 대체할 수 있습니다.
6. 정지 스크린샷 위의 포인터 움직임 또는 확대/축소는 실제 녹화가 아닌 일러스트레이션입니다. 정확하게 설명하십시오.
7. 진정한 성공적인 저장을 캡처하려면 승인된 격리된 테스트 환경을 사용하고 먼저 쓰기 대상을 확인하십시오. 그 후 테스트 레코드를 정리하십시오. 불가능한 경우 성공 메시지를 조작하지 말고 절차를 설명하십시오.

애플리케이션 스크린샷이나 데이터를 내레이션 제공자에게 보내지 마십시오. 사용자의 외부 처리 제한을 존중하여 일반 설명 텍스트만 보내십시오.

내레이션 및 아랍어 자막

• 음성 가용성을 확인하고 대표적인 구절을 테스트합니다. 지역 음성 식별자만으로는 방언, 공식 아랍어 또는 자연스러운 낭독이 확립되지 않습니다.
• 각 세그먼트에 대해 승인된 텍스트, 오디오 및 단어 경계를 유지합니다. 변경된 세그먼트만 다시 생성합니다.
• 텍스트, 음성, 속도 및 발음 설정에서 오디오 캐시 키를 파생합니다. 파일 존재만으로는 유효한 캐시 키가 아닙니다.
• 승인된 스크립트에서 SRT를 작성하고 구두점을 유지하며 단어를 타이밍 경계에 맞춥니다. 원시 전사 토큰을 조합하여 구두점을 잃지 마십시오.
• 정확한 정렬을 사용할 수 없는 경우 예상 타이밍을 문서화합니다. 정밀한 청취 기반 검증으로 설명하지 마십시오.
• 아랍어 렌더링을 확인합니다. RAQM을 사용한 기본 셰이핑을 선호하며 필요한 경우에만 reshaper/bidi를 사용합니다. 텍스트를 두 번 셰이핑하거나 역순으로 만들지 마십시오.
• 아랍어, 숫자 및 혼합 기술 텍스트로 글꼴을 테스트합니다. 불완전한 글꼴 하위 집합을 피하십시오.
• 중요 동작 영역 밖에 자막을 배치합니다. 휴대폰 크기에서 읽을 수 있고 가능하면 한두 줄 이내로 유지하십시오.

모션 및 브랜딩

• 실제 프로젝트에서 색상, 글꼴 및 로고를 추출합니다. 원본 로고를 다시 그리거나 색상을 변경하지 않고 사용합니다.
• 작은 스크린샷 주위에 모든 명령을 혼잡하게 배치하는 대신 현재 명령을 명확하게 표시합니다.
• 종횡비와 전체 관련 필드 또는 버튼을 유지하면서 동작 영역으로 점진적으로 확대/축소합니다.
• 명확한 포인터, 부드러운 움직임 및 유용한 위치에 간단한 클릭 표시를 사용합니다. 클릭을 해당 음성 명령과 일치시킵니다.
• 전환은 차분하게 유지합니다. 흔들림, 깜박임 및 목적 없는 반복 확대/축소를 피하십시오.
• 인트로와 엔딩이 요청된 경우 동일한 아이덴티티를 사용하고 로고, 조직 및 제목을 점진적으로 표시합니다. 8-12초와 같은 길이는 예시일 뿐 보편적인 요구 사항이 아닙니다.
• 제안된 태그라인을 공식적으로 승인된 슬로건으로 제시하지 마십시오.

화살표: 색상, 배치 및 모션

다음은 모든 기존 비디오에 대한 주장이 아닌 권장 프로덕션 기본값입니다. 애플리케이션의 밀도와 사용자의 참조에 맞게 조정하면서 납품 전체에서 일관된 주석 스타일을 유지하십시오.

외관

• 지침 화살표에는 빨간색 #D52424 을 사용하고, 밝은 인터페이스와 어두운 인터페이스 모두에서 구분되도록 흰색 #FFFFFF 외곽선을 사용합니다. 애플리케이션 자체 색상과 로고는 변경하지 않고 유지합니다.
• 1920×1080에서 5px 축, 2px 흰색 외곽선, 18px 화살촉, 약 90-160px 전체 길이로 시작합니다. 이러한 값을 출력 해상도에 비례하여 조정하고 휴대폰 크기에서 가독성을 확인합니다.
• 약 18% 불투명도와 3px 블러의 작은 검은색 그림자는 선택 사항입니다. 네온 글로우, 무거운 3D 효과, 이모지 또는 텍스트 화살표 글리프를 추가하지 마십시오. 주석을 깔끔한 벡터 경로 또는 고해상도 투명 레이어로 그립니다.
• 튜토리얼 화살표와 실제 마우스 포인터를 구분합니다. 화살표는 대상을 설명하고 포인터는 탐색 또는 실제 클릭을 나타냅니다. 둘 다 동일한 컨트롤을 가릴 때 표시하지 마십시오.

배치 및 좌표

• Full HD에서 약 6-12px의 여백을 두고 실제 버튼, 필드 또는 링크의 가장자리를 가리킵니다. 레이블, 입력 값, 아이콘, 포커스 윤곽선, 유효성 검사 메시지 또는 자막을 가리지 마십시오.
• 가까운 빈 공간에서 대각선 또는 짧은 곡선 경로를 선호합니다. 동작당 하나의 지침 화살표를 표시합니다. 여러 동작의 경우 화살표를 화면에 남겨두지 말고 순차적으로 표시합니다.
• 소스 캡처를 기준으로 대상 사각형 및 앵커를 저장합니다. 화살표 끝에 스크린샷과 동일한 자르기, 배율, 이동 및 확대/축소 변환을 적용합니다. 움직이는 확대/축소에 대해 고정된 화면 좌표를 하드코딩하지 마십시오.
• 추가 확대/축소/이동 전에 간단한 자르기 및 배율 매핑은 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 길이 대신 PCM/WAV 또는 샘플 수를 사용하여 오디오를 측정합니다.
• 실제 인코딩된 클립 길이 또는 프레임 그리드 반올림된 길이로 최종 타임라인을 구축합니다. 챕터 구분 기호 및 오디오 리드인/테일을 포함합니다.
• SRT 및 챕터 경계를 누적 반올림 드리프트가 있는 이전 타임라인이 아닌 최종 타임라인에 바인딩합니다.
• 설치된 FFmpeg 버전의 옵션을 검사합니다. filter_complex_script가 존재한다고 가정하지 마십시오. 적절한 경우 필터 그래프를 직접 전달하십시오.
• 후자를 거부하는 필터의 경우 .65와 같은 소수점 대신 0.65와 같은 십진수 길이를 작성합니다.
• 명시적 경로와 구조화된 하위 프로세스 인수를 사용합니다. 내레이션 또는 챕터 제목에서 셸 명령을 구성하지 마십시오.
• 이미지, 대상 사각형, 글꼴, 로고 또는 레이아웃 코드가 변경될 때 렌더 캐시를 무효화합니다.
• 독립 실행형 챕터를 내보낼 때 키프레임 경계와 오디오 시작을 검사합니다. 추출된 파일 자체를 확인합니다.

품질 검토 및 진실된 승인

자료에 적합한 검사를 수행합니다.

• 전체 비디오/오디오를 디코딩하고 해상도, 프레임 속도, 길이 및 트랙을 확인합니다.
• 음량 및 피크 레벨을 측정합니다. 간격 및 클리핑을 확인합니다.
• 승인된 스크립트와 자막을 비교하고 타이밍 순서와 최종 경계의 유효성을 검사합니다.
• 인트로, 엔딩, 확대/축소, 유효성 검사 메시지 및 성공 상태를 포함한 실제 최종 렌더링의 프레임을 검사합니다.
• 브라우저 또는 적합한 플레이어에서 재생 및 탐색을 테스트합니다. 휴대폰 크기 미리보기를 포함합니다.
• 참조된 각 요소가 존재하는지, 포커스 대상이 올바른지, 중요한 텍스트가 잘리지 않았는지 확인합니다.
• 요청된 경우 PDF, XLSX, 독립 실행형 클립 및 아카이브 내용의 유효성을 검사합니다.

자동 전사는 듣기가 아닙니다. ASR은 검토가 필요한 구절을 식별할 수 있지만 불일치는 인식 오류 또는 철자 차이일 수 있습니다.

기술적 검사, 자동화된 텍스트 비교, 문서화된 듣기 및 공식 승인을 별도로 기록합니다. 실제로 발생하지 않은 경우 듣기 또는 승인을 완료된 것으로 표시하지 마십시오.

필요한 직접 또는 사람의 듣기를 사용할 수 없는 경우 명확히 명시하십시오. 지원 파일과 세그먼트별 듣기 검토 기록을 전달하십시오. 완벽한 발음을 주장하지 마십시오. ASR 기반 변경을 확인된 듣기 수정으로 보고하지 마십시오.

발음 기록에는 타임스탬프, 세그먼트, 승인된 텍스트, 전사 또는 플래그가 지정된 단어, 요청된 수정 및 듣기/해결 상태가 포함되어야 합니다.

전달

요청된 이름과 형식을 따릅니다. 전체 전달에는 다음이 포함될 수 있습니다.

• 기본 MP4 및 별도의 인트로/엔딩.
• 내레이션 WAV, 아랍어 SRT 및 챕터 타임스탬프.
• 발음 검토 XLSX 및 확인 및 미해결 항목을 보여주는 품질 보고서 PDF.
• 스토리보드, 안전한 캡처, 글꼴/라이선스, 오디오 자산, 편집 코드 및 종속성 정보.
• 유용한 경우 독립 실행형 챕터 클립.

편집 프로젝트를 이식 가능하게 유지하십시오. 개발자 머신 경로 및 로그인 자격 증명을 제외하십시오. 아카이브를 만들기 전에 패키지를 검사하십시오. 존재하는 파일만 연결하고 수행되지 않은 작업을 주장하지 않고 자료 제한 사항을 명시하십시오.