beacon
Contents
startScan
비콘 정보를 주기적으로 전달한다.
filter(uuid, major, minor) 정보와 일치되는 비콘 정보만 successCallback 에 반환된다.
options
| 필드 | 필드 | 설명 | 비고 | M/O |
|---|---|---|---|---|
| scanId | 스캔 아이디 | 임의의 문자열 | M | |
| filter | 스캔필터 | M | ||
| uuid | 비콘 고유 ID | 16bytes 32개의 16진수로 표현되며, 총 36개문자(32개 문자와 4개의 하이픈)으로 구성 | M | |
| major | 비콘 major 번호 | 2bytes (1 ~ 65535의 정수) | O | |
| minor | 비콘 minor 번호 | 2bytes (1 ~ 65535의 정수) | O | |
successCallback
| 필드 | 필드 | 설명 | 비고 |
|---|---|---|---|
| result | 비콘 상세 정보 | JSON Array | |
| uuid | 비콘 고유 ID | 16bytes 32개의 16진수로 표현되며, 총 36개문자(32개 문자와 4개의 하이픈)으로 구성 | |
| major | 비콘 major 번호 | 2bytes (1 ~ 65535의 정수) | |
| minor | 비콘 minor 번호 | 2bytes (1 ~ 65535의 정수) | |
| rssi | 비콘 신호세기 | –99 ~ -35의 실수 | |
errorCallback
| 필드 | 설명 |
|---|---|
| code | 에러코드 |
| message | 에러메세지 |
Example
var scanId = "65521";
var filter = {
"uuid": "e2c56db5-dffb-48d2-b060-d0f5a71096e0",
"major": 40001,
"minor": 42719
};
hone.channel.execute('beacon', 'startScan', [scanId, filter],
function (result) {
alert("uuid:" + result[0].uuid);
}, function (e) {
alert(JSON.stringify(e));
}
);
var filter = {
"uuid": "e2c56db5-dffb-48d2-b060-d0f5a71096e0",
"major": 40001,
"minor": 42719
};
hone.channel.execute('beacon', 'startScan', [scanId, filter],
function (result) {
alert("uuid:" + result[0].uuid);
}, function (e) {
alert(JSON.stringify(e));
}
);
Result
[{
"uuid":"e2c56db5-dffb-48d2-b060-d0f5a71096e0",
"major": 40001,
"minor": 42719,
"rssi": -63
}]
"uuid":"e2c56db5-dffb-48d2-b060-d0f5a71096e0",
"major": 40001,
"minor": 42719,
"rssi": -63
}]
stopScan
동작 중인 scan를 종료한다.
options
| 필드 | 설명 | 비고 | M/O |
|---|---|---|---|
| scanId | 스캔 아이디 | startScan 에서 생성한 scanId 를 사용 | M |
successCallback
| 필드 | 설명 |
|---|---|
| 없음 | 없음 |
errorCallback
| 필드 | 설명 |
|---|---|
| code | 에러코드 |
| message | 에러메세지 |
Example
hone.channel.execute('beacon', 'stopScan', [scanId],
function() {
alert('success');
}, function(e) {
alert(JSON.stringify(e));
}
);
function() {
alert('success');
}, function(e) {
alert(JSON.stringify(e));
}
);
Error Code
| Code | Cause | Comment |
|---|---|---|
| E12700 | 파라메터 값이 잘못되어 있을 경우 | |
| E12701 | 전달된 액션 값이 알 수 없는 액션일 경우 | |
| E12702 | scan 아이디 값이 null 이거나 빈 값인 경우 | |
| E12703 | 비콘 고유 ID 값이 UUID 형식에 맞지않는 경우 | |
| E12704 | 비콘 major 번호가 1 ~ 65535 사이의 정수값이 아닌 경우 | |
| E12705 | 비콘 minor 번호가 1 ~ 65535 사이의 정수값이 아닌 경우 | |
| E12750 | 실행 중 오류가 발생 되었을 경우 | |
| E12751 | 블루투스 설정이 비활성화 되어있는 경우 | |
| E12752 | startScan 요청 시 scan 아이디 값이 존재하는 경우 | |
| E12753 | stopScan 요청 시 scan 아이디 값을 찾을 수 없는 경우 | |
| E12754 | 비콘 정보를 얻기위한 서비스가 지원하지 않는 경우 | |
| E12799 | 알 수없는 오류가 발생 되었을 경우 | |