screen
Contents
screen 는 디바이스의 화면 밝기 제어 및 화면 캡처 기능을 제공한다.
확장 프레임워크 파일을 추가하여 사용할 수 있으며 추가 방법은 iOS 개발 가이드 의 내용을 참조한다.
setBrightness
화면 밝기 설정 기능이며 호출 방법은 다음과 같다. 1~100 범위로 밝기를 설정할 수 있다.
options
| 필드 | 설명 | M/O |
|---|---|---|
| level | 화면 밝기 값 (1~100 사이 실수값) | M |
Example
DAPScreen.setBrightness(50, completion: { resultDict in
// TODO
}, failure: { error in
// TODO
})
// TODO
}, failure: { error in
// TODO
})
[DAPScreen setBrightness:50 completion:^(NSDictionary *resultDict) {
// TODO
} failure:^(NSError *error) {
// TODO
}];
// TODO
} failure:^(NSError *error) {
// TODO
}];
capture
capture 는 현재 구동중인 앱의 화면을 기준으로 이미지 파일을 생성하고 그 이미지 경로를 전달하도록 설계 되었으며 capture 이미지 내에 워터 마크를 추가할 수도 있다.
워터 마크가 추가되었을 경우에는 오른쪽 하단으로 위치가 고정되며 워터마크의 크기나 마진 값은 사용자가 워터 마크 이미지를 통해 조절할 수 있다.
capture 를 위해서 필요한 인자는 아래와 같으며 해당 인자는 Optional 한 값이므로 입력하지 않아도 무방하다.
options
| 필드 | 설명 | M/O |
|---|---|---|
| watermarkPath | capture 화면에 표기할 워터마크 이미지의 경로 | O |
<워터마크 이미지 경로 예>
절대 경로 - file:///var/mobile/Containers/Data/Application/AE8573C4-A1C0-404D-AEA8-0AE471D126DA/Library/honemobile/DEMOIOS/save/main/logo.png
상대 경로 (비즈앱 아이디 내 하위 경로) - mark.png
절대 경로 - file:///var/mobile/Containers/Data/Application/AE8573C4-A1C0-404D-AEA8-0AE471D126DA/Library/honemobile/DEMOIOS/save/main/logo.png
상대 경로 (비즈앱 아이디 내 하위 경로) - mark.png
capture 이미지의 저장 경로는 /appname/Library/honemobile/ScreenCapture/ (플러그인에서 사용하는 기본 경로이다. 앱의 라이브러리 폴더에 저장 된다.) 이고 파일명은 timestamp 형태로 생성하여 PNG 포맷에 이미지 퀄리티는 100으로 저장한 뒤 그 경로를 반환 한다.
이때 capture 에 대상이 되는 View 는 현재 보여지고 있는 RootViewController 화면을 캡쳐 하도록 구현되어 있다.
기본 Root 화면을 캡쳐를 하기 때문에 커스텀 영역 및 Window 화면 모두 캡쳐가 가능하다.
Example
let watermarkPath = "icon.png"
DAPScreen.capture(watermarkPath, completion: { resultDict in
// TODO
}, failure: { error in
// TODO
})
DAPScreen.capture(watermarkPath, completion: { resultDict in
// TODO
}, failure: { error in
// TODO
})
NSString *watermarkPath = @"icon.png";
[DAPScreen capture:watermarkPath completion:^(NSDictionary *resultDict) {
// TODO
} failure:^(NSError *error) {
// TODO
}];
[DAPScreen capture:watermarkPath completion:^(NSDictionary *resultDict) {
// TODO
} failure:^(NSError *error) {
// TODO
}];
Error Code
| Code | Cause | Comment |
|---|---|---|
| E12400 | 파라메터 값이 잘못되어 있을 경우 | |
| E12401 | 전달된 액션 값이 알 수 없는 액션일 경우 | |
| E12402 | 화면 밝기 값이 1~100 사이의 실수형값이 아닌 경우 | |
| E12403 | 워터마크 파일 경로가 잘못 되어 있는 경우 | |
| E12450 | 실행 중 오류가 발생 되었을 경우 | |
| E12451 | 요청한 비즈앱 경로가 잘못되어 있는 경우 | |
| E12452 | 워터마크 이미지 파일이 존재하지 않는 경우 | |
| E12499 | 알 수 없는 오류가 발생 되었을 경우 | |