device
device 는 HSP 에서 기본으로 제공하는 API 로 별도 설정 없이 사용 가능 하다.
사용자는 device 를 통해서 디바이스의 세부 정보, 설치되어 있는 BizApp 의 정보, 현재 연결되어 있는 네트워크의 정보, 마지막으로 Local 정보를 얻을 수 있다.
getDeviceInfo
getDeviceInfo 는 HSP 정보 및 Android 단말에 대한 정보를 얻을 수 있으며 그 세 부내용은 하단의 표를 참조 한다.
DeviceInfo Class
public static class DeviceInfo implements Serializable {
public final String libVersion;
public final String modelName;
public final String osName;
public final String osVersion;
public final String targetDeviceType;
}
public final String libVersion;
public final String modelName;
public final String osName;
public final String osVersion;
public final String targetDeviceType;
}
DeviceInfo
| 필드 | 설명 |
|---|---|
| libVersion | HONE 스마트 플랫폼 버전 (예: 4.5.12) |
| modelName | 디바이스 모델명 (예: SHW-M250S) |
| osName | 디바이스 운영체제 (예: Android) |
| osVersion | 디바이스 운영체제 버전 (예: 12) |
| targetDeviceType | preConfiguration.json 내의 targetDeviceType 값 반환 (예: All) |
Example
DAPDevice.getDeviceInfo(this@MainActivity, {
//TODO
}) {
//TODO
}
//TODO
}) {
//TODO
}
DAPDevice.getDeviceInfo(MainActivity.this, result -> {
// TODO
}, e -> {
// TODO
});
// TODO
}, e -> {
// TODO
});
getAppInfo
getAppInfo 는 HSP 에 설치되어 있는 BizApp 목록을 전달 하며 그 세부 내용은 하단을 참조 한다.
AppInfo Class
public static class AppInfo implements Serializable {
public final App app;
public final List<BizApp> bizapps;
}
public final App app;
public final List<BizApp> bizapps;
}
App Class
public static class App implements Serializable {
public final String appId;
public final String version;
}
public final String appId;
public final String version;
}
BizApp Class
public static class BizApp implements Serializable {
public final String bizappId;
public final String title;
public final String version;
}
public final String bizappId;
public final String title;
public final String version;
}
AppInfo
| 필드 | 필드 | 필드 | 설명 |
|---|---|---|---|
| appInfo | |||
| app | 앱정보 | ||
| version | 앱 버젼 (예: 1.5) | ||
| appId | 앱 아이디 (예: HoneSmartPlatformDemo) | ||
| bizapps | 비즈앱 정보 | ||
| bizappId | 비즈앱 아이디 (예: common) | ||
| title | 비즈앱 타이틀 (예: Biz App Title) | ||
| version | 비즈앱 버젼 (예: 1.0.0) | ||
Example
DAPDevice.getAppInfo(this@MainActivity, {
//TODO
}) {
//TODO
}
//TODO
}) {
//TODO
}
DAPDevice.getAppInfo(MainActivity.this, result -> {
// TODO
}, e -> {
// TODO
});
// TODO
}, e -> {
// TODO
});
getNetworkInfo
getNetworkInfo 는 현재 단말이 연결되어 있는 네트워크 정보를 전달 하며 보통 3G/4G 또는 Wi-Fi 등의 문자열을 JSONObject 에 "type" 키에 담아 반환 한다.
JSONObject
| 필드 | 필드 | 설명 |
|---|---|---|
| JSONObject | 현재 연결된 네트워크 정보 | |
| type | 네트워크 정보 (3g, wifi) | |
Example
DAPDevice.getNetworkInfo(this@MainActivity, , {
//TODO
}) {
//TODO
}
//TODO
}) {
//TODO
}
DAPDevice.getNetworkInfo(MainActivity.this, result -> {
// TODO
}, e -> {
// TODO
});
// TODO
}, e -> {
// TODO
});
getLocale
getLocale 은 단말에서 현재 사용중인 언어 정보를 JSONObject 에 "country", "language" 키에 담아 반환 한다.
JSONObject
| 필드 | 필드 | 설명 |
|---|---|---|
| JSONObject | 현재 지역 정보 | |
| country | 지역 (국가) | |
| language | 언어 | |
Example
DAPDevice.getLocale(this@MainActivity, {
//TODO
}) {
//TODO
}
//TODO
}) {
//TODO
}
DAPDevice.getLocale(MainActivity.this, result -> {
// TODO
}, e -> {
// TODO
});
// TODO
}, e -> {
// TODO
});
Error Code
| Code | Cause | Comment |
|---|---|---|
| E10300 | 파라메터 값이 잘못되어 있을 경우 | |
| E10301 | 전달된 액션 값이 알 수 없는 액션일 경우 | |
| E10350 | 실행 중 오류가 발생 되었을 경우 | |
| E10399 | 알 수 없는 오류가 발생 되었을 경우 | |