navigator.accelerometer.getCurrentAcceleration(accelerometerSuccess, accelerometerError);
function onSuccess(acceleration) {
alert('Acceleration X: ' + acceleration.x + '\n' +
'Acceleration Y: ' + acceleration.y + '\n' +
'Acceleration Z: ' + acceleration.z + '\n' +
'Timestamp: ' + acceleration.timestamp + '\n');
};
== acceleratorOption ==
^Option^설명^비고^
| frequency |가속도 정보를 조회하는 빈도를 의미한다.| |
==== Server Application ====
=== 관련 소스 ===
^유형^대상소스명^비고^
|Controller|egovframework.hyb.add.acl.web.EgovAcceleratorAndroidAPIController.java|AcceleratorAPI 가이드 프로그램 Controller Class|
|Service|egovframework.hyb.add.acl.service.EgovAcceleratorAndroidAPIService.java|AcceleratorAPI 가이드 프로그램 Service Class|
|ServiceImpl|egovframework.hyb.add.acl.service.impl.EgovAcceleratorAndroidAPIServiceImpl.java|AcceleratorAPI 가이드 프로그램 ServiceImpl Class|
|VO|egovframework.hyb.add.acl.service.AcceleratorAndroidAPIDefaultVO.java|AcceleratorAPI 가이드 프로그램 VO Class|
|VO|egovframework.hyb.add.acl.service.AcceleratorAndroidAPIFileVO.java|AcceleratorAPI 가이드 프로그램 VO Class|
|VO|egovframework.hyb.add.acl.service.AcceleratorAndroidAPIVO.java|AcceleratorAPI 가이드 프로그램 VO Class|
|VO|egovframework.hyb.add.acl.service.AcceleratorAndroidAPIXmlVO.java|AcceleratorAPI 가이드 프로그램 XML 관련 VO Class|
|DAO|egovframework.hyb.add.acl.service.impl.AcceleratorAndroidAPIDAO.java|AcceleratorAPI 가이드 프로그램 Dao Class|
|Util|egovframework.hyb.add.acl.service.impl.EgovAcceleratorAndroidFileMngUtil.java|AcceleratorAPI 가이드 프로그램 Util Class|
|QUERY XML|resources/egovframework/sqlmap/hyb/add/acl/EgovAcceleratorAndroidAPIGuide_XXX_mysql.xml|AcceleratorAPI 가이드 프로그램 QUERY XML|
|Idgen XML|resources/egovframework/spring/com/context-idgen.xml|AcceleratorAPI 가이드 프로그램 Id생성 Idgen XML|
=== 관련 테이블 ===
^테이블명^테이블명(영문)^비고^
|accelerator|ACCELERATOR|가속도 정보 관리|
=== 테이블 정의서 ===
* Device
^ No. ^ 컬럼ID ^ 컬럼명 ^ 타입 ^ 길이 ^ NULL ^
| 1 | SN | 일련번호 | NUMERIC | 6 | NotNull |
| 2 | UUID | UUID | VARCHAR | 50 | NotNull |
| 3 | XAXIS | X축값 | VARCHAR | 20 | Null |
| 4 | YAXIS | Y축값 | VARCHAR | 20 | Null |
| 5 | ZAXIS | Z축값 | VARCHAR | 20 | Null |
| 6 | TIMESTAMP | timestamp | VARCHAR | 20 | Null |
| 7 | USEYN | 활성화여부 | CHAR | 1 | Null |
=== ERD ===
{{:egovframework:hyb:guide:ios:erd.jpg|}}
===== 환경설정 =====
Accelerator 디바이스API 가이드 프로그램에서 제공하는 모바일 디바이스의 Accelerator 관련 기능을 활용하기 위하여 필요한 항목 및 그 환경 설정은 다음과 같다.
==== Device Application ====
=== res/xml/config.xml ===
=== res/values/serverinfo.xml ===
http://192.168.100.222:8080/DeviceAPIGuideTotal_Web_V1.7.1
=== AndroidManifest.xml ===
==== Server Application ====
=== context-properties.xml ===
* 업로드 된 파일 저장 위치
=== resource/egovframework/sqlmap/sql-map-config_[DB명].xml ===
===== 관련기능 =====
Accelerator 디바이스 API 가이드 프로그램은 크게 디바이스의 가속도 정보를 조회 하는 **가속도 정보 조회** 기능 및 서버 연계를 통한 **가속도 정보 저장**, ** 가속도 정보 목록 조회**, **가속도 정보 삭제** 기능으로 구성되어있다.
==== 가속도 정보 조회 ====
=== 비즈니스 규칙 ===
디바이스 API를 통해 현재 가속도 정보를 호출하여, 가속도 정보를 모니터링 창에 표시 및 3D 도형을 통해 가속도 방향으로 도형을 회전한다.
=== 관련코드 ===
디바이스 API 내의 Accelerator 함수를 사용하는 JavaScript 코드를 통해 실시간 가속도 정보를 조회 한다.
function fn_egov_update_Acceleration(accelInfo)
{
xaxis = accelInfo.x;
yaxis = accelInfo.y;
zaxis = accelInfo.z;
timeStamp = accelInfo.timestamp;
// accelInfo 객체내의 가속도 정보(x, y, z, timestamp)를 저장한다.
var html = "X : " + xaxis + "
" + "Y : " + yaxis + "
" + "Z : " + zaxis;
$("#infoDetail").css("text-align", "center");
$("#infoDetail").css("margin-left", "1px");
html += ""
$("#infoDetail").html(html);
if (firstRefresh)
{
accInitX = xaxis;
accInitY = yaxis;
accInitZ = zaxis;
firstRefresh = false;
}
console.log("DeviceAPIGuide fn_egov_update_Acceleration Success");
}
=== 관련화면 및 수행매뉴얼 ===
^가속도 정보 조회 화면^
|{{:egovframework:hyb:guide:add:가속도정보조회.jpg?320|}}|
==== 가속도 정보 저장 ====
=== 비즈니스 규칙 ===
조회 된 가속도 정보를 서버에 전송하여 리스트 형태로 저장한다. \\
=== 관련코드 ===
function fn_registAcceleratorInfo() {
useYn = "Y";
var url = "/acl/xml/addAcceleratorInfo.do";
var accept_type = "json";
var params = {uuid : device.uuid,
xaxis: xaxis + '',
yaxis: yaxis + '',
zaxis: zaxis + '',
timestamp: timeStamp + '',
useYn: useYn};
// send the data
egovHyb.post(url, accept_type, params, function(jsondata) {
var data = JSON.parse(jsondata);
if(data.useYn == "OK"){
fn_InquireAccelerationInfoListXml();
}else{
$("#alert_dialog").click( function() {
jAlert('데이터 전송 중 오류가 발생 했습니다.', '전송 오류', 'c');
});
}
});
console.log("DeviceAPIGuide fn_registAcceleratorInfo request Completed");
}
=== 관련화면 및 수행매뉴얼 ===
^기능^URL^Controller^method^화면(HTML)^
|가속도 정보 서버로 송신하기| /acl/xml/addAcceleratorInfo.do| EgovAcceleratorAndroidAPIController| addAcceleratorInfoXml |AcceleratorAPI.html|
정보데이터를 서버로 송신하기 위해서는 가속도 정보 저장 버튼을 클릭하면 된다. \\
가속도 정보 저장 : 가속도 정보를 서버로 송신하기 위해서는 하단의 가속도 정보 저장 버튼을 클릭한다. \\
가속도 정보 목록 : **가속도 정보 목록** 화면으로 이동한다. \\
==== 가속도 정보 목록 ====
=== 비즈니스 규칙 ===
서버에 저장 되어있는 가속도 정보 목록을 리스트 형태로 출력한다.
=== 관련코드 ===
function fn_InquireAccelerationInfoListXml()
{
if(!fn_egov_network_check(false)){
return;
}
var url = "/acl/xml/acceleratorInfoList.do";
var accept_type = "xml";
// get the data from server
window.plugins.EgovInterface.get(url,accept_type, null, function(xmldata) {
var list_html = "";
$(xmldata).find("acceleratorInfoList").each(function(){
var uuid = $(this).find("uuid").text();
var x = $(this).find("xaxis").text();
var y = $(this).find("yaxis").text();
var z = $(this).find("zaxis").text();
var t = $(this).find("timestamp").text();
list_html += "UUID : " + uuid + "
";
list_html += "xaxis : " + x + "
";
list_html += "yaxis : " + y + "
";
list_html += "zaxis : " + z + "
";
list_html += "timestamp : " + t + "
=== 관련화면 및 수행매뉴얼 ===
^기능^URL^Controller^method^화면(HTML)^
|가속도 정보 목록 조회하기|/acl/xml/acceleratorInfoList.do | EgovAcceleratorAndroidAPIController | selectAcceleratorInfoXMLList | AcceleratorAPI.html |
^가속도 정보 목록 화면^
|{{:egovframework:hyb:guide:add:가속도정보목록.jpg?320|}}|
서버에 저장 되어있는 가속도 정보 목록을 조회하기 위해서는 가속도 정보 목록 버튼을 클릭하면 된다. \\
가속도 정보 저장 : 가속도 정보를 서버로 송신하기 위해서는 하단의 가속도 정보 저장 버튼을 클릭한다. \\
가속도 정보 목록 : **가속도 정보 목록** 화면으로 이동한다. \\
가속도 정보 조회 : **가속도 정보 조회** 화면으로 이동한다. \\
가속도 정보 삭제 : 서버에 저장 되어있는 가속도 목록을 초기화 하기 위해서는 가속도 정보 삭제 버튼을 클릭한다.\\
==== 가속도 정보 삭제 ====
=== 비즈니스 규칙 ===
서버에 저장 되어있는 가속도 정보 목록을 초기화 한다.
=== 관련코드 ===
function fn_DelAccelerationInfoList() {
var url = "/acl/xml/withdrawal.do";
var accept_type = "json";
// send the data
egovHyb.post(url, accept_type, null, function(jsondata) {
var data = JSON.parse(jsondata);
if(data.useYn == "OK"){
$.mobile.changePage("#acceleratorInfo", { transition: "slide", reverse: true });
}else{
$("#alert_dialog").click( function() {
jAlert('데이터 삭제 중 오류가 발생 했습니다.', '삭제 오류', 'c');
});
}
});
console.log("DeviceAPIGuide fn_DelAccelerationInfoList request Completed");
}
=== 관련화면 및 수행매뉴얼 ===
^기능^URL^Controller^method^화면(HTML)^
|가속도 정보 목록 초기화하기|/acl/xml/withdrawal.do| EgovAcceleratorAndroidAPIController | withdrawalXml| AcceleratorAPI.html |
서버에 저장 되어있는 가속도 정보 목록을 초기화하기 위해서는 가속도 정보 목록 화면 하단의 가속도 정보 삭제 버튼을 클릭하면 된다. \\
가속도 정보 저장 : 가속도 정보를 서버로 송신하기 위해서는 하단의 가속도 정보 저장 버튼을 클릭한다. \\
가속도 정보 목록 : **가속도 정보 목록** 화면으로 이동한다. \\
가속도 정보 조회 : **가속도 정보 조회** 화면으로 이동한다. \\
가속도 정보 삭제 : 서버에 저장 되어있는 가속도 목록을 초기화 하기 위해서는 가속도 정보 삭제 버튼을 클릭한다.\\
===== 컴파일 디버깅 배포 =====
==== 컴파일 ====
=== AcceleratorAPI Device Applicaton 컴파일 방법 ===
* 프로젝트 선택 > 오른쪽 클릭 > Run As > Android Application
{{:egovframework:hyb:guide:add:카메라_컴파일1.png?740|}}
* 상단의 메뉴 > Run As > Android Application
{{:egovframework:hyb:guide:add:카메라_컴파일2.png?740|}}
* 실행할 타겟 선택 > 에뮬레이터, 디바이스(디버깅모드)
{{:egovframework:hyb:guide:add:디바이스컴파일.png?740|}}
* 에뮬레이터를 이용한 실행 화면
{{:egovframework:hyb:guide:add:accelerator애뮬.png?700|}}
* 디바이스를 이용한 실행 화면
{{:egovframework:hyb:guide:add:accelerator인트로.png|}}
=== DeviceInfoAPI Server Applicaton 컴파일 방법 ===
* DeviceInfoAPI 서버사이드 가이드 프로그램의 실행은 프로젝트를 마우스 오른쪽 버튼을 클릭 한후 Run As>Run On Server 버튼을 통해 실행 할 수 있다.
{{:egovframework:hyb:guide:ios:서버실행.png?640|}}
* 빌드가 성공적으로 수행 되면 이클립스의 콘솔 창에서 'Server Startup in xxx ms' 메시지를 확인 할 수 있다.
{{:egovframework:hyb:guide:add:서버실행결과_콘솔.png?840|}}
==== 디버깅 ====
디바이스 어플리케이션에서 발생한 오류 내용 확인 및 디버깅을 위해서는 폰갭 프레임워크에서 제공하는 console.log를 이용할 수 있다. console.log 함수는 자바스크립트 구문에서 사용할 수 있는 디버그 코드로 이클립스 및 Xcode에서 확인 할 수 있다.
console.log의 작성 방법의 예시는 다음과 같다.
function fn_egov_network_check(doCheck)
{
console.log('DeviceAPIGuide fn_egov_network_check');
var networkState = navigator.network.connection.type;
...
}
디버깅 코드가 실행 되면 아래와 같은 메시지를 개발도구의 콘솔 메시지 창에서 볼 수 있다.
{{:egovframework:hyb:guide:add:FileReadWriteconsolelog.png|}}
DeviceInfo 디바이스 API 가이드 프로그램 에서는 디버깅을 위하여 다음과 같이 콘솔 정보를 출력한다.
^디버그 코드^디버깅 내용^
|DeviceAPIGuide fn_InquireAccelerationInfoListXml request Completed| 서버에 저장된 네트워크 정보를 요청받아 XML 리스트 반환 성공 시|
|eviceAPIGuide fn_registAcceleratorInfo request Completed|디바이스의 Accelerator 정보를 서버로 업데이트 성공 시|
|DeviceAPIGuide fn_DelAccelerationInfoList request Completed|서버내의 Accelerator 정보 초기화 성공 시|
|DeviceAPIGuide fn_egov_update_Acceleration Success|디바이스의 Accelerator 정보 조회 후 관련 변수에 해당 정보 업데이트 성공 시|
|DeviceAPIGuide fn_egov_get_acceleration fail|디바이스의 Accelerator 정보 조회 실패 시|
==== 배포 ====
Accelerator 디바이스 API 가이드 다운로드 : [[http://www.egovframe.go.kr/cop/bbs/selectBoardArticle.do?bbsId=BBSMSTR_000000000161&nttId=514&menu=3&submenu=9|Click]] \\
===== 참고자료 =====
* UX/UI 라이브러리 : [[http://jquerymobile.com/|jQuery Mobile]] \\
* Hybrid : [[http://www.phonegap.com/|PhoneGap]] \\
* 3D 렌더링 : Three.js(https://github.com/mrdoob/three.js) \\