Skip to main content

AM3S

WorkFlow​

Connection to device​

1.Listen to device notify​

int callbackId = iHealthDevicesManager.getInstance().registerClientCallback(new iHealthDevicesCallback() {
    
    @Override
    public void onScanDevice(String mac, String deviceType, int rssi, Map manufactorData) {

    }

    @Override
    public void onDeviceConnectionStateChange(String mac, String deviceType, int status, int errorID, Map manufactorData) {

    }

    @Override
    public void onScanError(String reason, long latency) {
        
    }

    @Override
    public void onScanFinish() {
       
    }
});

iHealthDevicesManager.getInstance().addCallbackFilterForDeviceType(mClientCallbackId, iHealthDevicesManager.TYPE_AM3S);
iHealthDevicesManager.getInstance().addCallbackFilterForAddress(int clientCallbackId, String... macs)

2.Scan for AM3S devices​

iHealthDevicesManager.getInstance().startDiscovery(DiscoveryTypeEnum.AM3S);

3.Connect to AM3S devices​

iHealthDevicesManager.getInstance().connectDevice("", mac, iHealthDevicesManager.TYPE_AM3S)

Am3sControl control = iHealthDevicesManager.getInstance().getAm3sControl(mDeviceMac);

API reference​

Get AM device's IDPS information​

Am3sControl control = iHealthDevicesManager.getInstance().getAm3sControl(mDeviceMac);
/**
 * Return Value: {"protocolstring":"com.jiuan.AMV12","accessoryname":"AM4","firmwareversion":"1.3.8",*"hardwareversion":"1.0.0","manufacture":"iHealth","serialnumber":"004D32079148","modenumber":"AM4 11070"}
 */
String IDPSMessage = control.getIdps();

Reset the device​

Am3sControl control = iHealthDevicesManager.getInstance().getAm3sControl(mDeviceMac);
/**
 * @param id User's ID
 */
control.reset(long id);
// Return value
private iHealthDevicesCallback miHealthDevicesCallback = new iHealthDevicesCallback() {
    @Override
    public void onDeviceNotify(String mac, String deviceType, String action, String message) {
        if (AmProfile.ACTION_RESET_AM.equals(action)) {
            int confirm = obj.getInt(AmProfile.ACTION_RESET_AM);
        }
    } 
}

Get user id​

Am3sControl control = iHealthDevicesManager.getInstance().getAm3sControl(mDeviceMac);
control.getBattery();
// Return value
private iHealthDevicesCallback miHealthDevicesCallback = new iHealthDevicesCallback() {
    @Override
    public void onDeviceNotify(String mac, String deviceType, String action, String message) {
        if (AmProfile.ACTION_USERID_AM.equals(action)) {
            try {
                JSONObject obj = new JSONObject(message);
                int userId = obj.getInt(AmProfile.USERID_AM);
            } catch (JSONException e) {
                e.printStackTrace();
            }
        }
    } 
}

Get alarms' count​

Am3sControl control = iHealthDevicesManager.getInstance().getAm3sControl(mDeviceMac);
control.getAlarmClockNum();
// Return value
private iHealthDevicesCallback miHealthDevicesCallback = new iHealthDevicesCallback() {
    @Override
    public void onDeviceNotify(String mac, String deviceType, String action, String message) {
        if (AmProfile.ACTION_GET_ALARMNUM_AM.equals(action)) {
            try {
                JSONObject obj = new JSONObject(message);
                int alarmNum = obj.getInt(AmProfile.GET_ALARMNUM_AM);
                JSONArray arrId = obj.getJSONArray(AmProfile.GET_ALARMNUM_ID_AM);

            } catch (JSONException e) {
                e.printStackTrace();
            }
        }
    } 
}

Get alarm information by id​

Am3sControl control = iHealthDevicesManager.getInstance().getAm3sControl(mDeviceMac);
control.getAlarmClockDetail(int... ids);
// Return value
private iHealthDevicesCallback miHealthDevicesCallback = new iHealthDevicesCallback() {
    @Override
    public void onDeviceNotify(String mac, String deviceType, String action, String message) {
        if (AmProfile.ACTION_GET_ALARMINFO_AM.equals(action)) {
            try {
                JSONObject obj = new JSONObject(message);
                JSONArray alarmInfos = obj.getJSONArray(AmProfile.GET_ALARM_CLOCK_DETAIL);
                for (int i = 0; i < alarmInfos.length(); i++) {
                    JSONObject item = alarmInfos.get(i);
                    boolean sunday    = item.getBoolean(AmProfile.GET_ALARM_WEEK_SUNDAY_AM);
                    boolean monday    = item.getBoolean(AmProfile.GET_ALARM_WEEK_MONDAY_AM);
                    boolean tuesday   = item.getBoolean(AmProfile.GET_ALARM_WEEK_TUESDAY_AM);
                    boolean wednesday = item.getBoolean(AmProfile.GET_ALARM_WEEK_WEDNESDAY_AM);
                    boolean thursday  = item.getBoolean(AmProfile.GET_ALARM_WEEK_THURSDAY_AM);
                    boolean friday    = item.getBoolean(AmProfile.GET_ALARM_WEEK_FRIDAY_AM);
                    boolean saturday  = item.getBoolean(AmProfile.GET_ALARM_WEEK_SATURDAY_AM);
                    int alarmID       = item.getInt(AmProfile.GET_ALARM_ID_AM);
                    String time       = item.getBoolean(AmProfile.GET_ALARM_TIME_AM);
                    boolean isrepeat  = item.getBoolean(AmProfile.GET_ALARM_ISREPEAT_AM);
                    boolean isOpen    = item.getBoolean(AmProfile.GET_ALARM_ISON_AM);
                }
            } catch (JSONException e) {
                e.printStackTrace();
            }
        }
    } 
}

Set/Unset alarm​

Am3sControl control = iHealthDevicesManager.getInstance().getAm3sControl(mDeviceMac);
/**
 * @param id       Alarm id: 1, 2 or 3
 * @param hour     Alarm hour part: [0, 23]
 * @param min      Alarm minute part: [0, 59]
 * @param isRepeat Indicates whether it will repeat
 * @param weeks    The days in a week to repeat the alarm, week[0~6] indicates Sun~Sat.
 *                 And 1 indicates open, 0 indicates close.
 *                 {0, 1, 1, 1, 1, 1, 0} means the alarm will repeat on Mon, Tue, Wed, Thu, Fri.
 * @param isOn     true if want to set the alarm, false to unset it.
 */
control.setAlarmClock(int id, int hour, int min, boolean isRepeat, int[] weeks, boolean isOn);
// Return value
private iHealthDevicesCallback miHealthDevicesCallback = new iHealthDevicesCallback() {
    @Override
    public void onDeviceNotify(String mac, String deviceType, String action, String message) {
        if (AmProfile.ACTION_SET_ALARMINFO_SUCCESS_AM.equals(action)) {
            Log.i("", "set alarm info success");
        }
    } 
}

Delete alarm by id​

Am3sControl control = iHealthDevicesManager.getInstance().getAm3sControl(mDeviceMac);
/**
 * @param id Alarm id
 */
control.deleteAlarmClock(int id);
// Return value
private iHealthDevicesCallback miHealthDevicesCallback = new iHealthDevicesCallback() {
    @Override
    public void onDeviceNotify(String mac, String deviceType, String action, String message) {
        if (AmProfile.ACTION_DELETE_ALARM_SUCCESS_AM.equals(action)) {
            Log.i("", "delete alarm success");
        }
    } 
}

Get activity remind setting​

Am3sControl control = iHealthDevicesManager.getInstance().getAm3sControl(mDeviceMac);
control.getActivityRemind();
// Return value
private iHealthDevicesCallback miHealthDevicesCallback = new iHealthDevicesCallback() {
    @Override
    public void onDeviceNotify(String mac, String deviceType, String action, String message) {
        if (AmProfile.ACTION_GET_ACTIVITY_REMIND_AM.equals(action)) {
            try {
                JSONObject obj = new JSONObject(message);
                int time = obj.getString(AmProfile.GET_ACTIVITY_REMIND_TIME_AM);
                int isOpen = obj.getBoolean(AmProfile.GET_ACTIVITY_REMIND_ISON_AM);
            } catch (JSONException e) {
                e.printStackTrace();
            }
        }
    }
}

Set/Unset activity remind​

Am3sControl control = iHealthDevicesManager.getInstance().getAm3sControl(mDeviceMac);
/**

* @param hour Activity remind hour part: [0, 23]
* @param min  Activity remind minute part: [0, 59]
* @param isOn true if want to set activity remind, false to unset it.
*/
control.setActivityRemind(int hour, int min, boolean isOn);
// Return value
private iHealthDevicesCallback miHealthDevicesCallback = new iHealthDevicesCallback() {
    @Override
    public void onDeviceNotify(String mac, String deviceType, String action, String message) {
        if (AmProfile.ACTION_SET_ACTIVITYREMIND_SUCCESS_AM.equals(action)) {
          Log.i("", "set remind success");
        }
    } 
}

Get device state and battery information​

Am3sControl control = iHealthDevicesManager.getInstance().getAm3sControl(mDeviceMac);
control.queryAMState();
// Return value
private iHealthDevicesCallback miHealthDevicesCallback = new iHealthDevicesCallback() {
    @Override
    public void onDeviceNotify(String mac, String deviceType, String action, String message) {
        if (AmProfile.ACTION_QUERY_STATE_AM.equals(action)) {
            try {
                JSONObject obj = new JSONObject(message);
                int state   = obj.getInt(AmProfile.QUERY_STATE_AM);
                int battery = obj.getInt(AmProfile.QUERY_BATTERY_PERCENT_AM);

            } catch (JSONException e) {
                e.printStackTrace();
            }
        }
    } 
}

Set user ID​

Am3sControl control = iHealthDevicesManager.getInstance().getAm3sControl(mDeviceMac);
/**
 * @param id new user id
 */
control.setUserId(int id);
// Return value
private iHealthDevicesCallback miHealthDevicesCallback = new iHealthDevicesCallback() {
    @Override
    public void onDeviceNotify(String mac, String deviceType, String action, String message) {
        if (AmProfile.ACTION_SET_USERID_SUCCESS_AM.equals(action)) {
            Log.i("", "set userid success");
        }
    } 
}

Get user information​

Am3sControl control = iHealthDevicesManager.getInstance().getAm3sControl(mDeviceMac);
control.getUserInfo();
// Return value
private iHealthDevicesCallback miHealthDevicesCallback = new iHealthDevicesCallback() {
    @Override
    public void onDeviceNotify(String mac, String deviceType, String action, String message) {
        if (AmProfile.ACTION_GET_USERINFO_AM.equals(action)) {
            try {
                JSONObject obj = new JSONObject(message);
                int age = obj.getInt(AmProfile.GET_USER_AGE_AM);
                int step = obj.getInt(AmProfile.GET_USER_STEP_AM);
                int height = obj.getInt(AmProfile.GET_USER_HEIGHT_AM);
                int gender = obj.getInt(AmProfile.GET_USER_SEX_AM);
                int weight = obj.getInt(AmProfile.GET_USER_WEIGHT_AM);
                int unit = obj.getInt(AmProfile.GET_USER_UNIT_AM);
                int target1 = obj.getInt(AmProfile.GET_USER_TARGET1_AM);
                int target2 = obj.getInt(AmProfile.GET_USER_TARGET2_AM);
                int target3 = obj.getInt(AmProfile.GET_USER_TARGET3_AM);
            } catch (JSONException e) {
                e.printStackTrace();
            }
        }
    } 
}

Set user's BMR​

Am3sControl control = iHealthDevicesManager.getInstance().getAm3sControl(mDeviceMac);
control.setUserBmr(int bmr);
// Return value
private iHealthDevicesCallback miHealthDevicesCallback = new iHealthDevicesCallback() {
    @Override
    public void onDeviceNotify(String mac, String deviceType, String action, String message) {
        if (AmProfile.ACTION_SET_BMR_SUCCESS_AM.equals(action)) {
            Log.i("", "Set user's BMR success");
        }
    } 
}

Get the activity data​

Am3sControl control = iHealthDevicesManager.getInstance().getAm3sControl(mDeviceMac);
control.syncActivityData();
// Return value
private iHealthDevicesCallback miHealthDevicesCallback = new iHealthDevicesCallback() {
    @Override
    public void onDeviceNotify(String mac, String deviceType, String action, String message) {
        if (AmProfile.ACTION_SYNC_ACTIVITY_DATA_AM.equals(action)) {
            try {
                JSONObject obj = new JSONObject(message);
                JSONArray arr = obj.getJSONArray(AmProfile.SYNC_ACTIVITY_DATA_AM);
                for (int i = 0; i < arr.size(); i++) {
                    JSONObject item = arr.get(i);
                    JSONArray list = item.getJSONArray(AmProfile.SYNC_ACTIVITY_EACH_DATA_AM);
                    for (int i = 0; i < list.size(); i++) {
                        String time = arr.get(i).getString(AmProfile.SYNC_ACTIVITY_DATA_TIME_AM);
                        int stepLength = arr.get(i).getInt(AmProfile.SYNC_ACTIVITY_DATA_STEP_LENGTH_AM);
                        int step = arr.get(i).getInt(AmProfile.SYNC_ACTIVITY_DATA_STEP_AM);
                        int calorie = arr.get(i).getInt(AmProfile.SYNC_ACTIVITY_DATA_CALORIE_AM);
                    }
                }
            } catch (JSONException e) {
                e.printStackTrace();
            }
        }
    } 
}

Get current time activity data​

Am3sControl control = iHealthDevicesManager.getInstance().getAm3sControl(mDeviceMac);
control.syncRealData();
// Return value
private iHealthDevicesCallback miHealthDevicesCallback = new iHealthDevicesCallback() {
    @Override
    public void onDeviceNotify(String mac, String deviceType, String action, String message) {
        if (AmProfile.ACTION_SYNC_REAL_DATA_AM.equals(action)) {
            try {
                JSONObject obj = new JSONObject(message);
                int step = obj.getInt(AmProfile.SYNC_REAL_STEP_AM);
                int calorie = obj.getInt(AmProfile.SYNC_REAL_CALORIE_AM);
                int totalCalorie = obj.getInt(AmProfile.SYNC_REAL_TOTALCALORIE_AM);
            } catch (JSONException e) {
                e.printStackTrace();
            }
        }
    } 
}

Get sleep data​

Am3sControl control = iHealthDevicesManager.getInstance().getAm3sControl(mDeviceMac);
control.getBattery();
// Return value
private iHealthDevicesCallback miHealthDevicesCallback = new iHealthDevicesCallback() {
    @Override
    public void onDeviceNotify(String mac, String deviceType, String action, String message) {
        if (AmProfile.ACTION_SYNC_SLEEP_DATA_AM.equals(action)) {
            try {
                JSONObject obj = new JSONObject(message);
                JSONArray arr = obj.getJSONArray(AmProfile.SYNC_SLEEP_DATA_AM);
                for (int i = 0; i < arr.size(); i++) {
                    JSONObject item = arr.get(i);
                    JSONArray list = item.getJSONArray(AmProfile.SYNC_SLEEP_EACH_DATA_AM);
                    for (int i = 0; i < list.size(); i++) {
                        String time = arr.get(i).getString(AmProfile.SYNC_SLEEP_DATA_TIME_AM);
                        int level = arr.get(i).getInt(AmProfile.SYNC_SLEEP_DATA_LEVEL_AM);
                    }
                }
            } catch (JSONException e) {
                e.printStackTrace();
            }
        }
    } 
}

Set the system time to AM device​

Am3sControl control = iHealthDevicesManager.getInstance().getAm3sControl(mDeviceMac);
control.syncRealTime();
// Return value
private iHealthDevicesCallback miHealthDevicesCallback = new iHealthDevicesCallback() {
    @Override
    public void onDeviceNotify(String mac, String deviceType, String action, String message) {
        if (AmProfile.ACTION_SYNC_TIME_SUCCESS_AM.equals(action)) {
            Log.i("", "Set the system time to AM device success");
        }
    } 
}

Set hour mode​

Am3sControl control = iHealthDevicesManager.getInstance().getAm3sControl(mDeviceMac);
/**
 * @param hourMode The value should be one of following:
 * AmProfile.AM_SET_12_HOUR_MODE
 * AmProfile.AM_SET_24_HOUR_MODE
 * AmProfile.AM_SET_EXCEPT_EUROPE_12_HOUR_MODE
 * AmProfile.AM_SET_EUROPE_12_HOUR_MODE
 * AmProfile.AM_SET_EXCEPT_EUROPE_24_HOUR_MODE
 * AmProfile.AM_SET_EUROPE_24_HOUR_MODE
 */
control.setHourMode();
// Return value
private iHealthDevicesCallback miHealthDevicesCallback = new iHealthDevicesCallback() {
    @Override
    public void onDeviceNotify(String mac, String deviceType, String action, String message) {
        if (AmProfile.ACTION_SET_HOUR_MODE_SUCCESS_AM.equals(action)) {
            Log.i("", "Set hour mode success");
        }
    } 
}

Get hour mode​

Am3sControl control = iHealthDevicesManager.getInstance().getAm3sControl(mDeviceMac);
control.getHourMode();
// Return value
private iHealthDevicesCallback miHealthDevicesCallback = new iHealthDevicesCallback() {
    @Override
    public void onDeviceNotify(String mac, String deviceType, String action, String message) {
        if (AmProfile.ACTION_GET_HOUR_MODE_AM.equals(action)) {
            try {
                JSONObject obj = new JSONObject(message);
                int mode = obj.getInt(AmProfile.GET_HOUR_MODE_AM);
            } catch (JSONException e) {
                e.printStackTrace();
            }
        }
    } 
}