플래시 안전 감사은(는) 무엇을 하나요?
헤드리스 브라우저에서 페이지를 기록하거나 비디오를 읽어 EA의 IRIS 플래시 감지기를 WCAG 영역 임계값(화면의 0.111)과 함께 실행하고 Markdown + JSON 보고서를 작성합니다. 이는 스크리닝 목적이며 인증서가 아닙니다.
이 스킬의 폴더에서 자체 Python(.\venv\Scripts\python.exe, 아래에서는 python으로 표시)을 사용하여 명령을 실행하세요. --out을 전달하여 보고서를 사용자의 프로젝트에 저장할 수 있습니다.
1. 설정 (venv가 없거나 임포트가 실패하는 경우에만)
python -m venv .venv
.\venv\Scripts\python.exe -m pip install -r requirements.txt
.\venv\Scripts\python.exe -m playwright install chromium
2. 입력 선택
| 입력 | 사용 시기 |
|---|---|
--url https://... | 라이브 웹 페이지 |
--html 경로\page.html | 로컬 HTML 파일 |
--video 경로\clip.mp4 | 게임 캡처, 트레일러 또는 기존 비디오 |
python scripts/audit.py --url https://example.com
python scripts/audit.py --html page.html --duration 10
python scripts/audit.py --video clip.mp4
유용한 옵션: --duration(초, 기본값 10), --settle(초, 기본값 1), --viewport(기본값 1024x768), --out(기본값 reports/).
종료 코드 0 = 통과, 1 = 실패, 2 = 오류.
클릭, 호버, 스크롤은 지원되지 않습니다. 위험이 상호작용을 필요로 하는 경우 사용자에게 화면 녹화를 요청하고 --video를 사용하세요.
3. 보고서 읽기 (report.md)
- WCAG 2.3.1 결과가 유일한 판정입니다. 휘도 또는 빨간색 "플래시 실패" 프레임이 발견되면 실패입니다. 시간 범위를 인용하세요.
- 추가 경고(WCAG 아님) 는 IRIS 방송 규칙입니다(예: 2~3회/초 플래시가 몇 초 동안 지속). 이는 별도로 언급하고 절대 WCAG 실패라고 부르지 마세요.
- 페이지 녹화의 경우 프레임 속도의 절반보다 빠른 깜빡임(~12Hz)은 측정되지 않습니다. 이러한 콘텐츠를 "통과"라고 설명하지 마세요.
- 항상 면책 조항을 반복하세요: 통과가 페이지 안전을 증명하지는 않습니다.
4. 실패 시 제안할 수정 사항
- 플래시 속도를 초당 3회 미만으로 늦춥니다.
- 플래시 영역을 더 작게 만듭니다(1024x768에서 341x256 픽셀 미만).
- 플래시 상태 간의 밝기 대비를 줄입니다.
- 채도가 높은 빨간색 플래시를 피합니다.
@media (prefers-reduced-motion: reduce)를 준수하고 일시 중지/중지 제어를 추가합니다.
5. 안전 규칙
테스트 페이지, 감사된 페이지 또는 녹화물을 표시 브라우저에서 열지 말고 사용자에게 보여주거나 임베드하지 마세요. scripts/audit.py를 통해 헤드리스로만 실행하세요. 영상이 아닌 보고서를 공유하세요.