navigator.compass.getCurrentHeading(compassSuccess, compassError, compassOptions);
function onSuccess(heading) {
alert('Heading: ' + heading.magneticHeading);
};
function onError(error) {
alert('CompassError: ' + error.code);
};
navigator.compass.getCurrentHeading(onSuccess, onError);
== compassOption ==
^Option^설명^비고^
| frequency |나침반 정보를 조회하는 빈도를 의미한다.| |
| frequency |나침반 성공 콜백함수를 초기화 하는데 필요한 변화의 정도를 의미한다.| |
==== Server Application ====
=== 관련 소스 ===
^유형^대상소스명^비고^
|Controller|egovframework.hyb.add.cps.web.EgovCompassAndroidAPIController.java|CompassAPI 가이드 프로그램 Controller Class|
|Service|egovframework.hyb.add.cps.service.EgovCompassAndroidAPIService.java|CompassAPI 가이드 프로그램 Service Class|
|ServiceImpl|egovframework.hyb.add.cps.service.impl.EgovCompassAndroidAPIServiceImpl.java|CompassAPI 가이드 프로그램 ServiceImpl Class|
|VO|egovframework.hyb.add.cps.service.CompassAndroidAPIDefaultVO.java|CompassAPI 가이드 프로그램 VO Class|
|VO|egovframework.hyb.add.cps.service.CompassAndroidAPIFileVO.java|CompassAPI 가이드 프로그램 VO Class|
|VO|egovframework.hyb.add.cps.service.CompassAndroidAPIVO.java|CompassAPI 가이드 프로그램 VO Class|
|VO|egovframework.hyb.add.cps.service.CompassAndroidAPIXmlVO.java|CompassAPI 가이드 프로그램 XML 관련 VO Class|
|DAO|egovframework.hyb.add.cps.service.impl.CompassAndroidAPIDAO.java|CompassAPI 가이드 프로그램 Dao Class|
|Util|egovframework.hyb.add.cps.service.impl.EgovCompassAndroidFileMngUtil.java|CompassAPI 가이드 프로그램 Util Class|
|QUERY XML|resources/egovframework/sqlmap/hyb/add/cps/EgovCompassAndroidAPIGuide_XXX_mysql.xml|CompassAPI 가이드 프로그램 QUERY XML|
|Idgen XML|resources/egovframework/spring/com/context-idgen.xml|CompassAPI 가이드 프로그램 Id생성 Idgen XML|
=== 관련 테이블 ===
^테이블명^테이블명(영문)^비고^
|compass|COMPASS|나침반 정보 관리|
=== 테이블 정의서 ===
* Compass
^ No. ^ 컬럼ID ^ 컬럼명 ^ 타입 ^ 길이 ^ NULL ^
| 1 | SN | 일련번호 | NUMERIC | 6 | NotNull |
| 2 | UUID | UUID | VARCHAR | 50 | NotNull |
| 3 | DRC | 방향 | VARCHAR | 40 | Null |
| 4 | ACCRCY | 정확도 | VARCHAR | 10 | Null |
| 5 | USEYN | 활성화여부 | CHAR | 1 | Null |
| 6 | TIMESTAMP | timestamp | VARCHAR | 20 | Null |
=== ERD ===
{{:egovframework:hyb:guide:ios:erd.jpg|}}
===== 환경설정 =====
Compass 디바이스API 가이드 프로그램에서 제공하는 모바일 디바이스의 Compass 관련 기능을 활용하기 위하여 필요한 항목 및 그 환경 설정은 다음과 같다.
==== 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 ===
===== 관련기능 =====
Compass 디바이스 API 가이드 프로그램은 크게 디바이스의 나침반 정보를 조회 하는 **나침반 정보 조회** 기능 및 서버 연계를 통한 **나침반 정보 저장**, ** 나침반 정보 목록 조회**, **나침반 정보 삭제** 기능으로 구성되어있다.
==== 나침반 정보 조회 ====
=== 비즈니스 규칙 ===
디바이스 API를 통해 현재 나침반 정보를 호출하여, 나침반 정보를 모니터링 창에 표시 및 나침반 형태의 도형을 통해 디바이스의 방향에 따라 도형을 회전한다.
=== 관련코드 ===
디바이스 API 내의 Compass 함수를 사용하는 JavaScript 코드를 통해 실시간 나침반 정보를 조회 한다.
function fn_egov_update_heading(h)
{
drc = h.magneticHeading;
accrcy = h.headingAccuracy;
timestamp= h.timestamp;
// 새로운 각도 값을 받아옴
newHeading = Math.round(drc);
$("#compassMain").trigger("newHeading", newHeading);
var html = "방위각 : " + drc + "
";
$("#infoDetail").html(html);
if(CompassInsertCheck)
{
CompassInsertCheck = false;
}
console.log("DeviceAPIGuide fn_egov_update_heading Success");
}
function fn_egov_get_compass()
{
if (CompasswatchID === null)
{
//alert("Compass start");
//toast("Compass start");
CompassInsertCheck = true;
var options = { frequency: 1 };
CompasswatchID = navigator.compass.watchHeading(fn_egov_update_heading,
function(e)
{
console.log("DeviceAPIGuide fn_egov_get_compass fail");
},
options);
}
else
{
compassEvent();
navigator.compass.clearWatch(CompasswatchID);
CompasswatchID = null;
fn_egov_update_heading({ drc : "Off"});
//navigator.notification.alert("Compass stop");
//toast("Compass stop");
}
}
=== 관련화면 및 수행매뉴얼 ===
^나침반 정보 조회 화면^
|{{:egovframework:hyb3.6:guide:add:compass:compass_info.png?320}}|
==== 나침반 정보 저장 ====
=== 비즈니스 규칙 ===
조회 된 나침반 정보를 서버에 전송하여 리스트 형태로 저장한다. \\
=== 관련코드 ===
function fn_registCompassInfo() {
useYn = "Y";
var url = "/cps/xml/addCompassInfo.do";
var accept_type = "json";
var params = {uuid : device.uuid,
drc: drc + '',
accrcy: accrcy + '',
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_goCompassInfoListXml();
}else{
$("#alert_dialog").click( function() {
jAlert('데이터 전송 중 오류가 발생 했습니다.', '전송 오류', 'c');
});
}
});
console.log("DeviceAPIGuide fn_registCompassInfo request Completed");
}
=== 관련화면 및 수행매뉴얼 ===
^기능^URL^Controller^method^화면(HTML)^
|나침반 정보 서버로 송신하기 /cps/xml/addCompassInfo.do EgovCompassAndroidAPIController| addCompassInfoXml |CompassAPI.html|
정보데이터를 서버로 송신하기 위해서는 나침반 정보 저장 버튼을 클릭하면 된다. \\
나침반 정보 저장 : 나침반 정보를 서버로 송신하기 위해서는 하단의 나침반 정보 저장 버튼을 클릭한다. \\
나침반 정보 목록 : **나침반 정보 목록** 화면으로 이동한다. \\
==== 나침반 정보 목록 ====
=== 비즈니스 규칙 ===
서버에 저장 되어있는 나침반 정보 목록을 리스트 형태로 출력한다.
=== 관련코드 ===
function fn_goCompassInfoListXml()
{
if(!fn_egov_network_check(false)){
return;
}
var url = "/cps/xml/compassInfoList.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("compassInfoList").each(function(){
var uuid = $(this).find("uuid").text();
var x = $(this).find("drc").text();
var y = $(this).find("accrcy").text();
var t = $(this).find("timestamp").text();
list_html += "UUID : " + uuid + "
";
list_html += "drc : " + x + "
";
list_html += "accrcy : " + y + "
";
list_html += "timestamp : " + t + "
=== 관련화면 및 수행매뉴얼 ===
^기능^URL^Controller^method^화면(HTML)^
|나침반 정보 목록 조회하기|/cps/xml/compassInfoList.do | EgovCompassAndroidAPIController | selectCompassInfoXMLList | CompassAPI.html |
^나침반 정보 목록 화면^
|{{:egovframework:hyb3.6:guide:add:compass:compass_list.png?320|}}|
서버에 저장 되어있는 나침반 정보 목록을 조회하기 위해서는 나침반 정보 목록 버튼을 클릭하면 된다. \\
나침반 정보 저장 : 나침반 정보를 서버로 송신하기 위해서는 하단의 나침반 정보 저장 버튼을 클릭한다. \\
나침반 정보 목록 : **나침반 정보 목록** 화면으로 이동한다. \\
나침반 정보 조회 : **나침반 정보 조회** 화면으로 이동한다. \\
나침반 정보 삭제 : 서버에 저장 되어있는 나침반 목록을 초기화 하기 위해서는 나침반 정보 삭제 버튼을 클릭한다.\\
==== 나침반 정보 삭제 ====
=== 비즈니스 규칙 ===
서버에 저장 되어있는 나침반 정보 목록을 초기화 한다.
=== 관련코드 ===
function fn_deleteCompassInfoList() {
var url = "/cps/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($("#compassMain"), {reverse: true});
}else{
$("#alert_dialog").click( function() {
jAlert('데이터 삭제 중 오류가 발생 했습니다.', '삭제 오류', 'c');
});
}
});
console.log("DeviceAPIGuide fn_deleteCompassInfoList request Completed");
}
=== 관련화면 및 수행매뉴얼 ===
^기능^URL^Controller^method^화면(HTML)^
|나침반 정보 목록 초기화하기|/cps/xml/withdrawal.do| EgovCompassAndroidAPIController | withdrawalXml| CompassAPI.html |
서버에 저장 되어있는 나침반 정보 목록을 초기화하기 위해서는 나침반 정보 목록 화면 하단의 나침반 정보 삭제 버튼을 클릭하면 된다. \\
나침반 정보 저장 : 나침반 정보를 서버로 송신하기 위해서는 하단의 나침반 정보 저장 버튼을 클릭한다. \\
나침반 정보 목록 : **나침반 정보 목록** 화면으로 이동한다. \\
나침반 정보 조회 : **나침반 정보 조회** 화면으로 이동한다. \\
나침반 정보 삭제 : 서버에 저장 되어있는 나침반 목록을 초기화 하기 위해서는 나침반 정보 삭제 버튼을 클릭한다.\\
===== 컴파일 디버깅 배포 =====
==== 컴파일 ====
=== 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:hyb3.6:guide:add:compass:compass_run.png?320|}}
=== Server Applicaton 컴파일 방법 ===
* 서버사이드 가이드 프로그램의 실행은 프로젝트를 마우스 오른쪽 버튼을 클릭 한후 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?700|}}
DeviceInfo 디바이스 API 가이드 프로그램 에서는 디버깅을 위하여 다음과 같이 콘솔 정보를 출력한다.
^디버그 코드^디버깅 내용^
|DeviceAPIGuide fn_registCompassInfo request Completed| 디바이스의 Compass 정보를 서버로 업데이트 성공 시|
|DeviceAPIGuide fn_deleteCompassInfoList request Completed|서버내의 Compass 정보 초기화 성공 시|
|DeviceAPIGuide fn_egov_update_heading Success|디바이스의 Compass 정보 조회 후 관련 변수에 해당 정보 업데이트 성공 시|
|DeviceAPIGuide fn_egov_get_compass fail|디바이스의 Compass 정보 조회 실패 시|
==== 배포 ====
Compass 디바이스 API 가이드 다운로드 : [[http://www.egovframe.go.kr/cop/bbs/selectBoardArticle.do?bbsId=BBSMSTR_000000000161&nttId=1253&menu=3&submenu=9|Click]] \\
===== 참고자료 =====
* Cordova : [[https://cordova.apache.org|Click]] \\
* UX/UI 라이브러리 : jQuery Mobile[[http://jquerymobile.com/demos/1.4.5/|Click]] \\