스크린샷 관련 서비스

 특정 모니터 또는 특정 프로세스 창의 스크린샷을 획득 또는 저장하기 위한 기능들을 제공합니다.

 본 서비스에서 eXDevice+가 인식하는 프로세스의 창 영역은 다음과 같습니다.

<eXDevice+가 인식하는 프로세스 창 영역>

 또한 웹 브라우저의 경우 Windows 정책 상 현재 포커스 된 창의 포커스 된 탭의 타이틀만 식별할 수 있습니다. 즉, 특정 브라우저에 포커스가 가 있지 않은 경우 해당 브라우저의 마지막으로 오픈한 창의 오픈된 탭의 타이틀을 검색할 수 있습니다.

<eXDevice+ 브라우저 타이틀 인식 예시>

서비스 리스트

 스크린샷 관련 서비스 리스트는 다음과 같습니다.

No.	서비스명	API명	비고
1	모니터 스크린샷 획득	WinInfo.GetScreenShot
2	모니터 스크린샷 저장	WinInfo.SaveScreenShot
3	타이틀 기반 프로세스 창 스크린샷 획득	WinInfo.GetWindowScreenShot
4	타이틀 기반 프로세스 창 스크린샷 저장	WinInfo.SaveWindowScreenShot

서비스 상태 코드 리스트

 본 서비스에서 공통으로 사용되는 서비스 상태코드 리스트에 대해 정의합니다.

 이 상태 코드는 응답 JSON 메시지 중 return 또는 returnValue의 값에 해당합니다.

리턴코드	리턴 코드 내용	대상 서비스	비고
-1	정의되지 않은 예외	공통	Log 파일에서 내용 확인 필요
0	정상	공통	-
2	PC와 연결된 모니터 리스트 획득 실패	GetScreenShot, SaveScreenShot
3	요청 모니터 정보 획득 실패	GetScreenShot, SaveScreenShot
6	대상 타이틀을 가진 프로세스가 없음	GetWindowScreenShot, SaveWindowScreenShot, GetProcessScreenShot, SaveProcessScreenShot
10	창 최소화 모드에서 스크린샷 획득 불가	GetWindowScreenShot, SaveWindowScreenShot, GetProcessScreenShot, SaveProcessScreenShot
11	스크린샷 획득 실패	GetWindowScreenShot, SaveWindowScreenShot, GetProcessScreenShot, SaveProcessScreenShot
12	파일 저장 실패	SaveScreenShot, SaveWindowScreenShot, SaveProcessScreenShot

1. 모니터 스크린샷 획득

API명

• WinInfo.GetScreenShot

정의

• 지정한 모니터의 화면을 캡처하고, 캡처한 이미지를 Base64 String으로 획득합니다.

모니터와 관련된 정보는 "모니터 관련 서비스" 문서를 참고하시길 바랍니다.

호출예시

{
  "service":"WinInfo.GetScreenShot",
  "requestKey":"Random Request Key",
  "param":{ 
    "screenIndex": 4
  }
}

• screenIndex
  • 화면을 캡처할 모니터 인덱스.
  • 시스템이 인식하는 모니터 명칭에서 숫자 값. (예: DISPLAY4 → 4)

응답예시

{
  "service":"WinInfo.GetScreenShot",
  "requestKey":"호출시 사용한 Request Key",
  "statusCode":"0000",
  "return":{
    "returnValue":0,
    "screenShotBase64":"/9j/4AAQSkZJRgABAQEAYABgAAD/2wBDAAMCAgMCAgMDAwMEA..."
  }
}

• returnValue
  • 서비스 상태 코드.
• screenShotBase64
  • Base64 String 데이터로 인코딩 된 모니터 스크린샷 데이터.

2. 모니터 스크린샷 저장

API명

• WinInfo.SaveScreenShot

정의

• 지정한 모니터의 화면을 캡처하고, 캡처한 이미지를 로컬 디스크에 저장합니다.

모니터와 관련된 정보는 "모니터 관련 서비스" 문서를 참고하시길 바랍니다.

호출예시

{
  "service": "WinInfo.SaveScreenShot",
  "requestKey": "Random Request Key",
  "param": { 
    "screenIndex": 4,
    "filePath": "D:\\test.jpg"
  }
}

• screenIndex
  • 화면을 캡처할 모니터 인덱스.
  • 시스템이 인식하는 모니터 명칭에서 숫자 값. (예: DISPLAY4 → 4)
• filePath
  • 스크린샷을 저장할 로컬 파일 경로.

응답예시

{
  "service":"WinInfo.SaveScreenShot",
  "requestKey":"호출시 사용한 Request Key",
  "statusCode":"0000",
  "return":0
}

• return
  • 서비스 상태 코드.

3. 타이틀 기반 프로세스 창 스크린샷 획득

API명

• WinInfo.GetWindowScreenShot

정의

• 타이틀을 가지는 프로세스의 창(Window)을 찾고, 해당 창을 캡쳐한 이미지를 Base64 String으로 획득합니다.

프로세스의 창이 최소화 모드인 경우 해당 창의 스크린샷을 획득할 수 없습니다.

호출예시

{
  "service":"WinInfo.GetWindowScreenShot",
  "requestKey":"Random Request Key",
  "param": {
    "processTitle":"TOMATOSYSTEM"
  }
}

• processTitle
  • 캡쳐할 프로세스 창의 타이틀.

응답예시

{
  "service":"WinInfo.GetWindowScreenShot",
  "requestKey":"호출시 사용한 Request Key",
  "statusCode":"0000",
  "return":{
    "returnValue":0,
    "screenShotBase64":"/9j/4AAQSkZJRgABAQEAYABgAAD/2wBDAA..."
  }
}

• returnValue
  • 서비스 상태 코드.
• screenShotBase64
  • Base64 String 데이터로 인코딩 된 프로세스 창 스크린샷 데이터.

4. 타이틀 기반 프로세스 창 스크린샷 저장

API명

• WinInfo.SaveWindowScreenShot

정의

• 타이틀을 가지는 프로세스의 창(Window)을 찾고, 해당 창을 캡처한 이미지를 로컬 디스크에 저장합니다.

프로세스의 창이 최소화 모드인 경우 해당 창의 스크린샷을 획득할 수 없습니다.

호출예시

{
  "service":"WinInfo.SaveWindowScreenShot",
  "requestKey":"Random Request Key...",
  "param":{
    "processTitle":"TOMATOSYSTEM",
    "filePath":"C:\\test.jpg"
  }
}

• processTitle
  • 캡쳐할 프로세스 창의 타이틀.
• filePath
  • 스크린샷을 저장할 로컬 파일 경로.

응답예시

{
  "service":"WinInfo.SaveWindowScreenShot",
  "requestKey":"호출시 사용한 Request Key",
  "statusCode":"0000",
  "return":0
}

• return
  • 서비스 상태 코드.

5. PID 기반 프로세스 창 스크린샷 획득

API명

• WinInfo.GetProcessScreenShot

정의

• 특정 프로세스 ID(PID)를 가지는 프로세스 창(Window)을 찾고, 해당 창을 캡쳐한 이미지를 Base64 String으로 획득합니다.

프로세스의 창이 최소화 모드인 경우 해당 창의 스크린샷을 획득할 수 없습니다.

호출예시

{
  "service":"WinInfo.GetProcessScreenShot",
  "requestKey":"Random Request Key",
  "param":{
    "processId":1234
  }
}

• processId
  • 검색할 프로세스 ID.

응답예시

{
  "service":"WinInfo.GetProcessScreenShot",
  "requestKey":"호출시 사용한 Request Key",
  "statusCode":"0000",
  "return":{
    "returnValue":0,
    "screenShotBase64":"/9j/4AAQSkZJRgABAQEAYABgAAD/2w..."
  }
}

• returnValue
  • 서비스 상태 코드.
• screenShotBase64
  • Base64 String 데이터로 인코딩 된 프로세스 창 스크린샷 데이터.

6. PID 기반 프로세스 창 스크린샷 저장

API명

• WinInfo.SaveWindowScreenShot

정의

• 특정 프로세스 ID(PID)를 가지는 프로세스 창(Window)을 찾고, 해당 창을 캡쳐한 이미지를 로컬 디스크에 저장합니다.

호출예시

{
  "service":"WinInfo.SaveProcessScreenShot",
  "requestKey":"Random Request Key",
  "param":{
    "processId":1234,
    "filePath":"C:\\test.jpg"
  }
}

• processId
  • 검색할 프로세스 ID.
• filePath
  • 스크린샷을 저장할 로컬 경로.

응답예시

{
  "service":"WinInfo.SaveProcessScreenShot",
  "requestKey":"호출시 사용한 Request Key",
  "statusCode":"0000",
  "return":0
}

• return
  • 서비스 상태 코드.