screen


screen은 3.0.0 버전 이상 부터 제공되며 해당 라이브러리를 추가하여 사용해야 된다.

brightness

화면 밝기를 설정한다.

options

필드설명M/O
value화면 밝기 값(1~100 사이 실수값)M
   

successCallback

필드설명
없음없음
  

errorCallback

필드설명
code에러코드
message에러메세지
  

Example

var value = 50;
hone.channel.execute('screen', 'brightness', [value],
   function () {
    }, function (e) {
        alert(JSON.stringify(e));
    }
);

capture

screen 내 capture 는 3.7.13 버전 이상 부터 제공되며 해당 라이브러리를 추가하여 사용해야 된다.

capture 는 현재 구동중인 앱의 화면을 기준으로 이미지 파일을 생성하고 그 이미지 경로를 전달하도록 설계 되었으며 capture 이미지 내에 워터 마크를 추가할 수도 있다.
워터 마크가 추가되었을 경우에는 오른쪽 하단으로 위치가 고정되며 워터마크의 크기나 마진 값은 사용자가 워터 마크 이미지를 통해 조절할 수 있다

capture 를 위해서 필요한 인자는 아래와 같으며 해당 인자는 Optional 한 값이므로 입력하지 않아도 무방하다. 

options

필드설명M/O
watermarkPathcapture 화면에 표기할 워터마크 이미지의 경로O
   
<워터마크 이미지 경로 예>
절대 경로 - file://var/mobile/Containers/Data/Application/AE8573C4-A1C0-404D-AEA8-0AE471D126DA/Library/honemobile/DEMOIOS/save/main/logo.png
상대 경로 (비즈앱 아이디 내 하위 경로) - img/watermark.png

successCallback

필드설명
path캡쳐이미지 경로
  

errorCallback

필드설명
code에러코드
message에러메세지
  

Example

var waterMarkPath = 'img/watermark.png';
hone.channel.execute('screen', 'capture', [waterMarkPath],
   function (path) {
        alert(path);
    }, function (e) {
        alert(JSON.stringify(e));
    }
);

Result

"file:///Users/5CFCF3AB-D294-4316-B537-C928A40B9498/Library/honemobile/DEMO/ScreenCapture/1644473013.961956.jpg" 

Error Code

CodeCauseComment
E12400파라메터 값이 잘못되어 있을 경우 
E12401전달된 액션 값이 알 수 없는 액션일 경우 
E12402화면 밝기 값이 1~100 사이의 실수형값이 아닌 경우 
E12403워터마크 파일 경로가 잘못 되어 있는 경우 
E12450실행 중 오류가 발생 되었을 경우 
E12451요청한 비즈앱 경로가 잘못되어 있는 경우 
E12452워터마크 이미지 파일이 존재하지 않는 경우 
E12499알 수 없는 오류가 발생 되었을 경우