널리

들어가기 전에

• 1부에서 언급한 바와 같이 아티클 전반에서는 NVDA의 추가 기능 패키지(*.nvda-addon)를 사용하지 않으며, NVDA 사용자 환경 폴더 내 appModule, globalPlugins 폴더에 작업물을 저장합니다. 추가 기능 패키지(*.nvda-addon)를 제작하는 방법은 추후 다룰 예정입니다. NVDA 사용자 환경 폴더를 여는 방법은 NVDA 추가 기능 개발 가이드라인 1부 <추가 기능이 저장된 폴더 열기> 섹션을 참고합니다.
• NVDA는 Python 언어로 추가 기능을 제작할 수 있습니다. 2부에서 사용한 NVDA에 내장된 클래스, 메소드 왜 Python 언어의 문법, 튜토리얼 등의 자세한 내용은 Python 공식 문서 웹사이트 https://docs.python.org/ko/2.7/를 참고하세요.
  
• NVDA는 Python 언어로 추가 기능을 제작할 수 있습니다. 2부에서 사용한 NVDA에 내장된 클래스, 메소드 왜 Python 언어의 문법, 튜토리얼 등의 자세한 내용은 Python 공식 문서 웹사이트 https://docs.python.org/ko/2.7/를 참고하세요.
  
• NVDA에 기본으로 포함된 추가 기능을 위한 모듈에 대해서는 NVDA 추가 기능 모듈 문서를 통해 내장 모듈, 클래스 및 메소드에 대한 설명을 확인할 수 있습니다.

추가 기능 코드의 구성

1. 추가 기능 작성 시 먼저 추가 기능에 대한 선택적인 머리글 (예 : 추가 기능의 이름 및 추가 기능의 간단한 설명 등)을 작성하는 것으로 시작합니다. 이 부분은 선택 사항이지만, 추가 기능의 역할, 용도를 아는 데 도움이 되므로 작성하는 것이 좋습니다.
2. 다음으로, 추가 기능 파일에 필요한 모듈을 NVDA에 알려줍니다. 이 작업은 <import module>을 작성하여 수행됩니다. 여기서 module은 코드에서 사용할 모듈의 이름입니다. 예를 들어, 추가 기능을 사용하는 동안 비프음을 재생하기 위해서는 import tones 구문을 작성합니다. 일반적으로 특정 추가 기능에 대해 두 개 이상의 모듈을 사용해야 할 수도 있습니다. 추가 기능에서 사용할 수 있는 여러 모듈에 대해서는 다음 글에서 자세히 설명합니다.
   
3. 필요한 모듈을 선언한 후, 추가 기능 코드 (클래스, 변수, 메소드) 등을 작성합니다. 가장 중요한 섹션은 코드를 할당할 추가 기능 모듈 유형을 결정하는 추가 기능 클래스 코드입니다. 세 예제를 통해 추가 기능 클래스에 대해 간단히 살펴보겠습니다.
   
4. 클래스를 선언한 다음 추가 기능에 필요한 코드를 작성합니다. 추가 기능 작성 시 Python 공식 문서, 외부 모듈을 사용한다면 모듈 문서를 참고합니다.
   
5. 추가 기능을 실행하려면, NVDA 추가 기능 개발 가이드라인 1부 내 <추가 기능 폴더 열기> 섹션을 참고하여 추가 기능 폴더를 연 다음 .py 파일을 appModules 또는 globalPlugins 폴더에 붙여 넣습니다.

추가 기능 첫 번째 예제: 단축키를 눌러 음성 메시지 출력하기

첫 번째 예제에 대한 코드 설명

1. 파일의 첫 번째, 두 번째 줄에는 추가 기능의 명칭 및 제작자 정보로 추가 기능 예제임을 명확히 알려 NVDA 추가 기능 관련 파일임을 명시했습니다. 추가 기능의 라이선스 등과 같은 중요 정보를 추가할 수도 있습니다.
2. 이 예제는 글로벌 플러그인이므로 import globalPluginHandler 구문을 통해 글로벌 플러그인 작성을 위한 모듈을 불러왔습니다.
   
3. import ui 구문을 작성하여 NVDA의 내장된 음성이나 점자로 메시지를 출력하기 위한 모듈을 불러왔습니다. 주어진 모듈의 메소드를 사용하고자 할 때 필요한 모듈을 import 구문을 통해 불러올 수 있습니다.
   
4. 글로벌 플러그인을 작성하기 위한 <GlobalPlugin이>라는 클래스를 정의했습니다. 괄호 안의 텍스트는 이 클래스가 어디에서 왔는지 알려줍니다.
   
5. 클래스 내 script_outputMessage 메소드는 단축키를 누를 때 실행되는 메소드입니다. 이 스크립트에서 메시지가 음성으로 출력되도록 NVDA에 알리기 위해 ui.message(u'안녕하세요. NVDA 추가 기능 개발 가이드라인의 첫 번째 예제입니다.')를 작성했습니다.
6. 마지막으로 outputMessage 스크립트에 단축키를 NVDA+Shift+A에 할당하기 위해 __gestures 블록에 "kb:NVDA+A":"outputMessage"를 작성했습니다. __gestures 블록에는 스크립트에 대한 단축키 또는 터치 명령을 할당하며, Python의 사전형으로 정의합니다.

참고

추가 기능을 처음 작성하는 사용자를 위한 팁

1. 추가 기능을 개발할 때, 한 번에 한 가지 기능을 작성하고 테스트합니다. 예를 들어, 특정 단축키를 누를 때마다 각기 다른 기능(음성 메시지 출력 또는 브라우저 주소 열기 등)과 같이 여러 기능을 개발하려 한다면, 한 가지 기능을 먼저 개발한 후 테스트하는 것이 좋습니다.
2. 응용 프로그램을 위한 앱 모듈을 작성하려면, 응용 프로그램의 설명서 및 사용법을 충분히 익혀야 합니다.
   
3. 추가 기능에서 사용될 단축키를 정의할 때 NVDA의 기본 단축키와 충돌하지 않도록 NVDA의 설명서를 참조하여 확인합니다.

두 번째 예제: 이벤트가 발생할 때 비프음 재생하기

두 번째 예제에 대한 코드 설명

1. 파일의 첫 번째, 두 번째 줄에는 추가 기능에 대한 헤더를 작성하여 추가 기능이 어떤 역할 및 기능을 하는지 작성했습니다.
2. 두 번째 예제도 글로벌 플러그인이므로 import globalPluginHandler 구문을 통해 글로벌 플러그인 작성을 위한 모듈을 불러왔습니다.
   
3. import 구문을 통해 현재 초점이 있는 객체, 클립보드 복사와 같은 일반적인 함수가 정의된 api, 체크 상자, 라디오 버튼과 같은 컨트롤과 상호 작용을 위한 controlTypes, 비프음을 재생하기 위한 tones 모듈을 불러왔습니다.
   
4. 글로벌 플러그인을 작성하기 위해 GlobalPlugin 클래스를 정의했습니다.
   
5. 클래스 내 event_gainFocus, event_loseFocus 메소드를 통해 <네이버> 링크에 초점을 이동하거나 초점을 벗어났을 때 비프음이 재생되도록 처리합니다.

세 번째 예제: 특정 응용 프로그램에서 NVDA를 일시 중지하기

세 번째 예제에 대한 코드 설명

1. 파일의 첫 번째, 두 번째 줄은 두 예제와 같이 추가 기능의 기본적인 정보 및 제작자 정보를 명시하였습니다.
2. 세 번째 예제는 Firefox 웹 브라우저 응용 프로그램만을 대상으로 하여 작동하므로, 앱 모듈 제작 시 필수적으로 요구되는 appModuleHandler 모듈을 불러왔습니다.
   
3. 앱 모듈 작성을 위해 AppModule class를 정의했습니다.
   
4. appModuleHandler.AppModule에 정의된 sleepMode 변수를 true로 설정하여 Firefox 웹 브라우저에서 NVDA가 작동하지 않도록 처리했습니다.

2부에서 사용된 NVDA 내장 모듈 목록

• api: 현재 초점을 받은 객체 및 클립보드 복사 기능과 같은 일반적인 함수가 정의된 모듈
• appModuleHandler: 앱 모듈 제작 시 필수적으로 필요한 모듈
  
• controlTypes: 체크 상자, 라디오 버튼과 같은 컨트롤과의 상호 작용을 처리하기 위한 모듈
  
• globalPluginHandler: 글로벌 플러그인을 제작하기 위한 필수 모듈
  
• tones: 비프음 재생을 위한 모듈
  
• ui: 음성 및 점자로 사용자에게 메시지를 출력하기 위한 용도로 사용되며, 예제 1에서 음성 출력을 위해 사용