P6SCoreSDK(Android)DOC

Catalogue

Initialization

Initialization/Deinitialization

Integration

use file in lib directory

Initialize SDK

1.call init method

DevicesManage.getInstance().initAll();

2.Set SDK command of recepetion and callback

xxxxxxxxxx
DevicesOperate.getInstance().setCallBack(ReceiveSettingListener.getInstance(app));

3.init cache

xxxxxxxxxx
DevicesManage.getInstance().initMaxMemory(application);

optimize

we add return number for some methods of command,the type is short with data in the middle of [1, 23767],if the return number is not in the scope, it means send command error, for example:

short cmdSeq = DevicesManage.getInstance().cmd902();

we add serial number for broadcast,it same with the return number ,for example

short receiveSeq = intent.getShortExtra(CmdSeqManager.SERIAL, (short) 0);

Device Connection

P2P Connection

Query the P2P connection status of the device and connect the device

xxxxxxxxxx
public void checkStatus(final String did);

1. Function function description

   • Query the P2P status of the device

   • Connect device

   • Declaration class

     xxxxxxxxxx
     DevicesManage.java
     

2. Declare class description context (dependent interfaces or which interfaces are used with)

   • You need to call this command before using the SDK to operate the device

3. Param

   Param	Details
   did	Device DID

4. Return

   Return	Details
   action	ConstantsCore.Action.GET_DEVICES_STATE
   status	Device status： 1：online 2：offline
   ConstantsCore.DID	Device DID

5. Simple sample code

   xxxxxxxxxx
   DevicesManage.getInstance().checkStatus(deviceDID);
   

Example：

​x
  private BroadcastReceiver receiver = new BroadcastReceiver() {
​
        @Override
        public void onReceive(Context context, Intent intent) {
            String action = intent.getAction();
            String did = intent.getStringExtra(ConstantsCore.DID);
            switch (action) {
                 case ConstantsCore.Action.GET_DEVICES_STATE:
                     int status = intent.getIntExtra("status", Constants.DeviceState.OFFLINE);
                 break;
            }
        }
  };

Login Device

xxxxxxxxxx
public short verification(String did, String user, String password);

1. Function function description

   • Login device (i.e. V1 authentication)

   • Declaration class

     xxxxxxxxxx
     DevicesManage.java
     

2. Declare class description context (dependent interfaces or which interfaces are used with)

   • After connecting to the device, log in to the device and then perform other operations

3. Param

   Param	Details
   did	Device DID
   user	Device user name
   password	Device password

4. Return

   Return	Details
   action	ConstantsCore.Action.RET_AUTH
   result	Login status： ok: Login success pwd : Password error usr : Not user nomore_session : The maximum number of devices allowed to log in has been reached. Login is denied WeakPassword : Weak password
   ConstantsCore.DID	Device DID
   DeviceShared	1:Support sharing
   AutoBind	1:Support resetting and unbinding

5. Simple sample code

   xxxxxxxxxx
   DevicesManage.getInstance().verification(did, userName, passWord);
   

Example：

xxxxxxxxxx
  private BroadcastReceiver receiver = new BroadcastReceiver() {
​
        @Override
        public void onReceive(Context context, Intent intent) {
            String action = intent.getAction();
            String did = intent.getStringExtra(ConstantsCore.DID);
            switch (action) {
                 case ConstantsCore.Action.RET_AUTH:
                     String result = intent.getStringExtra(ConstantsCore.RESULT);
                     String deviceShared = intent.getStringExtra("DeviceShared");
                     String autoBind = intent.getStringExtra("AutoBind");
                 break;
            }
        }
  };

Login Device support sharing

xxxxxxxxxx
public short verificationV2(String did, String user, String password, String user_role_info, String role);

1. Function function description

   • Login Device support sharing

   • Declaration class

     xxxxxxxxxx
     DevicesManage.java
     

2. Declare class description context (dependent interfaces or which interfaces are used with)

   • After connecting to the device, need login device

3. Param

   Param	Details
   did	Device DID
   user	Device user name
   password	Device password
   user_role_info	get “encrypt” value from server api
   role	use “OWN” or “GUE”

4. Return

   Return	Details
   action	ConstantsCore.Action.RET_AUTHV2
   result	Login status： ok: Login success
   ConstantsCore.DID	Device DID
   ScodeFailed	"1":when user-role-info error
   AutoBind	Support resetting and unbinding

5. Simple sample code

   xxxxxxxxxx
   DevicesManage.getInstance().verificationV2(did, userName, passWord, user_role_info, role);
   

Example：

xxxxxxxxxx
  private BroadcastReceiver receiver = new BroadcastReceiver() {
​
        @Override
        public void onReceive(Context context, Intent intent) {
            String action = intent.getAction();
            String did = intent.getStringExtra(ConstantsCore.DID);
            switch (action) {
                 case ConstantsCore.Action.RET_AUTHV2:
                     String result = intent.getStringExtra(ConstantsCore.RESULT);
                 break;
            }
        }
  };

###

Get device Information

xxxxxxxxxx
public short getDeviceInfo(String did);

1. Function function description

   • Get the basic information of the device immediately after login. Get the basic information of the device before real-time preview and remote playback.g

   • Declaration class

     xxxxxxxxxx
     DevicesManage.java
     

2. Param

   Param	Details
   did	Device DID

3. Return

   Return	Details
   action	ConstantsCore.Action.RET_DEVICEINFO
   ConstantsCore.DID	Device DID
   model	Device model
   vendor	Name of manufacturer
   serial_no	Device serial number
   channel	Count of channels
   version	Version information
   dev_type	Device type: such as IPC, DVR, NVR, IPD,

4. Simple sample code

   xxxxxxxxxx
   DevicesManage.getInstance().getDeviceInfo(did);
   

Example：

xxxxxxxxxx
  private BroadcastReceiver receiver = new BroadcastReceiver() {
​
        @Override
        public void onReceive(Context context, Intent intent) {
            String action = intent.getAction();
            String did = intent.getStringExtra(ConstantsCore.DID);
            switch (action) {
                 case ConstantsCore.Action.RET_DEVICEINFO:
                 break;
            }
        }
  };

###

Get device Information

xxxxxxxxxx
public short getDeviceCap(String did);

1. Function function description

   • acquiring capability of device

   • Declaration class

     xxxxxxxxxx
     DevicesManage.java
     

2. Param

   Param	Details
   did	Device DID

3. Return

   Return	Details
   action	ConstantsCore.Action.RET_DEVICECAP
   ConstantsCore.DID	Device DID
   sd	"yes" support tf card
   wifi	"yes" support wifi

4. Simple sample code

   xxxxxxxxxx
   DevicesManage.getInstance().getDeviceCap(did);
   

Example：

xxxxxxxxxx
  private BroadcastReceiver receiver = new BroadcastReceiver() {
​
        @Override
        public void onReceive(Context context, Intent intent) {
            String action = intent.getAction();
            String did = intent.getStringExtra(ConstantsCore.DID);
            switch (action) {
                 case ConstantsCore.Action.RET_DEVICECAP:
                 break;
            }
        }
  };

###

Disconnect Device

xxxxxxxxxx
public void disconnectDevice(String... dids);

1. Function function description

   • Disconnect the device

   • Declaration class

     xxxxxxxxxx
     DevicesManage.java
     

2. Declare class description context (dependent interfaces or which interfaces are used with)

   • Disconnect the device after the operation is completed

3. Param

   Param	Details
   dids	Device DID,(one or more DIDs)

4. Return

   Nothing

5. Simple sample code

   xxxxxxxxxx
   DevicesManage.getInstance().disconnectDevice(did);
   

Query the status of the device on the server

xxxxxxxxxx
public void checkServerStatus(final String did);

1. Function function description

   • Query the status of the device on the server

   • Declaration class

     xxxxxxxxxx
     DevicesManage.java
     

2. Declare class description context (dependent interfaces or which interfaces are used with)

   • Query the status of the device on the server and detect the status of the device on the server for subsequent display

3. Param

   Param	Details
   did	Device DID

4. Return

   Return	Details
   action	ConstantsCore.Action.GET_DEVICES_SERVER_STATE
   status	Device status：1：online, -3:timeout,-6：offline

5. Simple sample code

   xxxxxxxxxx
   DevicesManage.getInstance().checkServerStatus(did);
   

Example：

xxxxxxxxxx
  private BroadcastReceiver receiver = new BroadcastReceiver() {
​
        @Override
        public void onReceive(Context context, Intent intent) {
            String action = intent.getAction();
            String did = intent.getStringExtra(ConstantsCore.DID);
            switch (action) {
                 case ConstantsCore.Action.GET_DEVICES_SERVER_STATE:
                      int status = intent.getIntExtra("status", Constants.DeviceServerState.OFFLINE);
                 break;
            }
        }
  };

Get the last time the device was on the server

xxxxxxxxxx
public void checkServerOffline(final String did);

1. Function function description

   • Get the last time the device was on the server, unit: second, max is 86400*365, over one year or never login return -1

   • Declaration class

     xxxxxxxxxx
     DevicesManage.java
     

2. Declare class description context (dependent interfaces or which interfaces are used with)

   • Detect the status of the device on the server for subsequent display

3. Param

   Param	Details
   did	Device DID

4. Return

   Return	Details
   action	ConstantsCore.Action.GET_DEVICES_SERVER_OFFLINE
   offline	Offline time of equipment

5. Simple sample code

   xxxxxxxxxx
   DevicesManage.getInstance().checkServerOffline(did);
   

Example：

xxxxxxxxxx
  private BroadcastReceiver receiver = new BroadcastReceiver() {
​
        @Override
        public void onReceive(Context context, Intent intent) {
            String action = intent.getAction();
            String did = intent.getStringExtra(ConstantsCore.DID);
            switch (action) {
                 case ConstantsCore.Action.GET_DEVICES_SERVER_OFFLINE:
                     int offline = intent.getIntExtra("offline", 0);
                 break;
            }
        }
  };

Device offline callback

xxxxxxxxxx
public void regStreamOfflineListener(String did, P2POfflineListener listener)

1. Function function description

   set offline listner

    

2. Declare class description context (dependent interfaces or which interfaces are used with)

   After the connection is successful, if the interface is registered, a callback will be received when the device is disconnected

3. Param

   Param	Details
   did	device did

4. Sample

x
  DevicesManage.getInstance().regStreamOfflineListener(mDid, new P2POfflineListener() {
                    @Override
                    public void onOffline(int errorCode) {
​
                    }
                });

LAN detection equipment

Note: initialize shakemanager before using SDK, and then complete the authentication operation

Related Classes

xxxxxxxxxx
ShakeManager.java

Initialization

xxxxxxxxxx
ShakeManager.getInstance().setHandler(handler);   
ShakeManager.getInstance().setSearchTime(15 * 1000); 
//optimize need <uses-permission android:name="android.permission.WAKE_LOCK" />
//WifiManager.MulticastLock lock = manager.createMulticastLock("localWifi");
//ShakeManager.getInstance().setLock(lock);   

Start detecting LAN devices

xxxxxxxxxx
public boolean shaking()

1. Function function description

   • Start detecting LAN devices

   • Declaration class

     xxxxxxxxxx
     ShakeManager.java
     

2. Declare class description context (dependent interfaces or which interfaces are used with)

   • You need to call this command before connecting to the LAN device

3. Param

   Nothing

4. Return

   Return	Details
   ip	Device ip address
   DID	Device DID
   mac	Device mac address
   qrKey	Scan the QR code of the distribution network to determine whether the equipment matches
   firmVersion	Device version

5. Simple sample code

   xxxxxxxxxx
    ShakeManager.getInstance().shaking();
   

Example：

xxxxxxxxxx
{
    "ip": "192.168.1.100",
    "DID": "IOTBCC-726091-BJPVG",
    "mac": "5A:58:E1:D2:5D:D8",
    "sid": "36338956",
    "qrKey": "\u0000\u0000\u0000\u0000\u0000",
    "firmVersion": "S855/5520PHR-AI/WH\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000"
}

xxxxxxxxxx
private Handler handler = new Handler() {
​
        @Override
        public void handleMessage(Message msg) {
            super.handleMessage(msg);
​
            switch (msg.what) {
                case ShakeManager.HANDLE_ID_SEARCH_END:
                    break;
                case ShakeManager.HANDLE_ID_RECEIVE_DEVICE_INFO:
                    String obj = msg.obj.toString();  
                    LogUtils.e("rzk", "result: " + obj);
                    break;
            }
        }
    }

Stop detecting LAN devices

xxxxxxxxxx
public void stopShaking();

1. Function function description

   • Stop detecting LAN devices

   • Declaration class

     xxxxxxxxxx
     ShakeManager.java
     

2. Declare class description context (dependent interfaces or which interfaces are used with)

   • Called when the probe needs to be stopped manually

3. Param

   Nothing

4. Return

   Nothing

5. Simple sample code

   xxxxxxxxxx
           if(ShakeManager.getInstance().isShaking()){ 
               ShakeManager.getInstance().stopShaking();
           }
   

Example：

xxxxxxxxxx
private Handler handler = new Handler() {
​
        @Override
        public void handleMessage(Message msg) {
            super.handleMessage(msg);
​
            switch (msg.what) {
                case ShakeManager.HANDLE_ID_SEARCH_END: 
                    break;
            }
        }
    }

Device binding process

The flow chart of device binding is as follows:

Add device to user device list

1. Path：/safe/add-device

2. Type：POST

3. Function function description

   • Add device to user list
   • This is the CGI interface to interact with the server, so please call it in HTTP mode

4. Describe the context (dependent interfaces or used with those interfaces)

   • The device must be added to the user device list before binding. Devices that do not support sharing or reset unbinding do not need to be bound

5. Param

   Param	Details
   did	Device DID
   sn	Enterprise serial number
   alias	Device alias

6. Return

   Return	Details
   data	code 200 indicates success
   code	The return code 200 indicates success
   error	Prompt information

   xxxxxxxxxx
   //Example
   {
       code = 200;
       data = null;
       error = null;
   }
   

7. Simple sample code

xxxxxxxxxx
public static void addDevice(final Context context, final String did, String userName, String pwd,
                                 String alias, String dtype, final AddDeviceCallback callBack) {
​
        Map<String, Object> params = new HashMap<>();
        params.put("sn", SN);
        params.put("did", did);
        params.put("username", userName);
        params.put("pwd", pwd);
        if (TextUtils.isEmpty(dtype)){
            params.put("dtype",dtype);
        }
        params.put("alias", alias);
        EasyHttp.getInstance().postJson(context, getUrl(ADD_DEVICE), params, new EasyCallBack() {
            @Override
            public void onSuccess(String result) {
                String code = LoginDataUtils.getCode(result);
                String data= LoginDataUtils.getData(result);
                int codeInt = -1;
                try {
                    codeInt = Integer.parseInt(code);
                } catch (Exception e) {
                    e.printStackTrace();
                }
                if (callBack != null) {
                    callBack.onResult(codeInt, 0, result);
                }
                
            }
​
            @Override
            public boolean onFail(int status, String msg) {
                if(callBack != null) {
                    callBack.onResult(status, 0, null);
                }
                return true;
            }
        });
    }

Connecting devices

For details, please checkQuery the P2P connection status of the device and connect the device

Login Device

For details, please checkLogin Device

Get SCode code of the device

xxxxxxxxxx
DevicesManage.getInstance().cmd902(DID, GET_BIND_CONFIG, "");

1. Function function description

   • Get SCode code of the device

   • Declaration class

     xxxxxxxxxx
     DevicesManage.java
     

2. Describe the context (dependent interfaces or used with those interfaces)

   • Only devices that support resetting and unbinding have scode codes. Devices that can obtain scode codes need to unbind first
   • The data returned by the device is XML text, which needs to be converted into key value pairs by itself

3. Param

   Param	Details
   did	Device DID

4. Return

   Return	Details
   SCodeVaild	false：No Scode ,or true
   SCode	When SCodeVaild is true, scode code can be obtained

   xxxxxxxxxx
   <DeviceBindConfig>
       <SCodeValid><!--ro,opt,xs:boolean”true”,”false”--></SCodeValid>
       <SCode><!--rw,req,xs:string--></SCode>
   </DeviceBindConfig>
   

5. Simple sample code

   xxxxxxxxxx
   DevicesManage.getInstance().cmd902(DID, GET_BIND_CONFIG, "");
   ​
   private BroadcastReceiver receiver = new BroadcastReceiver() {
   ​
           @Override
           public void onReceive(Context context, Intent intent) {
               String action = intent.getAction();
               String did = intent.getStringExtra(ConstantsCore.DID);
               switch (action) {
                   case Constants.Action.GET_SET_CONFIG_BY_HTTP:
                       String http = intent.getStringExtra("http");
                       if (!HttpUtils.checkInvalid(http)) {
                           return;
                       }
                       String responseXML = HttpUtils.getResponseXML(http);     
                       String xmlInfo = HttpUtils.getHttpXmlInfo(responseXML);  
                       if (xmlInfo == null) { 
                          return;
                       }
   ​
                       String did = intent.getStringExtra("deviceId");
                       if (xmlInfo.equals("DeviceBindConfig")) {
                           BindConfig bc = XmlUtils.parseBindConfig(responseXML); 
                       }
                       break;
               }
           }
     };
   ​
   ​
       public static BindConfig parseBindConfig(String response) {
           SAXReader reader = new SAXReader();
           BindConfig obs = null;
           try {
               Element root = reader.read(HttpUtils.str2Is(response)).getRootElement();
               if ("DeviceBindConfig".equalsIgnoreCase(root.getName())) {
                   Iterator<Element> obsIt = root.elementIterator();
                   obs = new BindConfig();
                   while (obsIt.hasNext()) {
                       Element obsNode = obsIt.next();
                       if ("SCode".equalsIgnoreCase(obsNode.getName())) {
                           obs.SCode = obsNode.getText();
                       } else if ("SCodeValid".equalsIgnoreCase(obsNode.getName())) {
                           obs.SCodeValid = obsNode.getText();
                       }
                   }
               }
           } catch (DocumentException e) {
               e.printStackTrace();
           }
           return obs;
       }
   ​
   

Upload device scode code

xxxxxxxxxx
String cmd = "PUT /System/DeviceBindConfig" + "\r\n\r\n" + PutXMLString.getBindConfig(info.getsCode());
DevicesManage.getInstance().cmd902(info.getDid(), cmd, "");

1. Function function description

   • Upload device scode code

   • Declaration class

     xxxxxxxxxx
     DevicesManage.java
     

2. Describe the context (dependent interfaces or used with those interfaces)

   • The device that supports resetting and unbinding gets the new scode code after binding and uploads it to the device. After the upload is successful, V2 authentication is performed
   • XML text is required to upload to the device

3. Param

   Param	Details
   SCode	SCode

4. Return

   Return	Details
   requestURL	Request URL
   statusCode	status，0:Request Success

xxxxxxxxxx
<DeviceBindConfig>
    <SCode><!--rw,req,xs:string--></SCode>
</DeviceBindConfig>
​
​
<ResponseStatus Version=\"1.0\">    
    <requestURL>/System/DeviceBindConfig</requestURL> 
    <statusCode>0</statusCode>
</ResponseStatus>

5. Simple sample code

   xxxxxxxxxx
   String cmd = "PUT /System/DeviceBindConfig" + "\r\n\r\n" + PutXMLString.getBindConfig(info.getsCode());
   DevicesManage.getInstance().cmd902(info.getDid(), cmd, "");
   ​
   ​
   private BroadcastReceiver receiver = new BroadcastReceiver() {
   ​
           @Override
           public void onReceive(Context context, Intent intent) {
               String action = intent.getAction();
               String did = intent.getStringExtra(ConstantsCore.DID);
               switch (action) {
                   case Constants.Action.GET_SET_CONFIG_BY_HTTP:
                       String http = intent.getStringExtra("http");
                       if (!HttpUtils.checkInvalid(http)) {
                           return;
                       }
                       String responseXML = HttpUtils.getResponseXML(http);     
                       String xmlInfo = HttpUtils.getHttpXmlInfo(responseXML);  
                       if (xmlInfo == null) { 
                          return;
                       }
   ​
                       String did = intent.getStringExtra("deviceId");
                       if (xmlInfo.equals("ResponseStatus")) {
                           RESPONSESTATUS response = XmlUtils.parseResponse(responseXML);
                           if (response.requestURL.contains("/System/DeviceBindConfig")){
                               if ("0".equals(response.statusCode)) {
                                   
                               } 
                           }
                       }
                       break;
               }
           }
     };
   ​
   

   6.Unbinding Device

   xxxxxxxxxx
   public static String DEVICE_UNBIND = "/safe/device-unbind"; 
   

   1. Function function description

      • Unbinding device

   2. Describe the context (dependent interfaces or used with those interfaces)

      • If the device that supports resetting and unbinding can obtain the scode code, unbind the device first

   3. Param

      Param	Details
      did	Device DID
      sCode	Device sCode

   4. Return

      xxxxxxxxxx
      //Example
      {
          code = 200;
          data = null;
          error = null;
      }
      

   5. Simple sample code

      xxxxxxxxxx
        Map<String, Object> params = new HashMap<>();
        params.put("did", did);
        params.put("sCode", sCode);
        EasyHttp.getInstance().postJson(mActivity, getUrl(DEVICE_UNBIND), params,new EasyCallBack() {
            @Override
            public void onSuccess(String result) {
                
                bindDevice(did, dtype);
            }
            @Override
            public boolean onFail(int status, String msg) {
                connHostFailed();
                return true;
            }
        });
      

      7.Only shared device binding is supported

      xxxxxxxxxx
      public static final String SHARE_ADD_HOST = "/safe/device-to-host";
      

      1. Function function description

         • Device binding supporting sharing

      2. Describe the context (dependent interfaces or used with those interfaces)

         • The method of binding a device that only supports sharing and a device that supports resetting and unbinding to become a master is different
         • Unbinding devices that support reset must support sharing
         • After becoming the master, do V2 authentication directly

      3. Param

         Param	Details
         did	Device DID
         sn	Enterprise serial number

      4. Return

         Return	Details
         data	Device identity encryption information
         code	The return code 200 indicates success
         error	Prompt information

         xxxxxxxxxx
         //Example
         {
          code = 200;
             data = "SMjOwVRLRHr/5Ct+yG/q655hpOoyShhszVNSL1ll7TaJl8LniWGMMJ/QyTatjNn0IqpqvXMAYQs=";;
             error = null;
         }
         

   6. Simple sample code

      xxxxxxxxxx
             public static void deviceToHost(Context context, String sn, String did, final AddHostCallback callback){
              Map<String, Object> params = new HashMap<>();
           params.put("sn", sn);
                 params.put("did", did);
         
                 EasyHttp.getInstance().postJson(context,HttpConst.getUrl(SHARE_ADD_HOST), params, new EasyCallBack() {
                     @Override
                     public void onSuccess(String result) {
                         String data = LoginDataUtils.getData(result);
                         String code = LoginDataUtils.getCode(result);
                         if(callback != null) {
                             if(!TextUtils.isEmpty(data)) {
                              callback.onSuccess(data);
                             } else {
                                 callback.onFailed(code, data);
                             }
                         }
                     }
         
                     @Override
                     public boolean onFail(int status, String msg) {
                         if(callback != null) {
                             callback.onFailed("-5000", null);
                         }
                         return true;
                     }
                 });
             }
      

      8.Support resetting unbound device binding

      xxxxxxxxxx
      public static String DEVICE_BIND = "/safe/device-bind"; 
      

      1. Function function description

         • Support sharing and resetting unbound device binding

      2. Describe the context (dependent interfaces or used with those interfaces)

         • The method of binding a device that only supports sharing and a device that supports resetting and unbinding to become a master is different
         • Unbinding devices that support reset must support sharing
         • After becoming the master, you need to get the scode code of the server and upload it to the device. After the upload is successful, you need to do V2 authentication

      3. Param

         Param	Details
         did	Device DID
         sn	Enterprise serial number

      4. Return

         Return	Details
         code	The return code 200 indicates success
         data	Key value pair
         error	Prompt information

         data键值对	Details
         sCode	Scode used for unbinding
         encrypt	Device authentication information
         id	Device table ID

         xxxxxxxxxx
         //Example
         {
             "code": 200,
             "data": {
                 "encrypt": "SMjOwVRLRHr/5Ct+yG/q655hpOoyShhszVNSL1ll7TaJl8LniWGMMJ/QyTatjNn0IqpqvXMAYQs=",
                 "id": 2553182,
                 "sCode": "164938234123568514602102-0400000"
             },
             "error": null
         }
         

      5. Simple sample code

      xxxxxxxxxx
        private void bindDevice(final String did, String dtype) {
              DeviceInfo info = fList.getDeviceInfoById(did);
              if (info == null) return;
      ​
              Map<String, Object> params = new HashMap<>();
              params.put("sn", HttpConst.SN);
              params.put("did", did);
              params.put("dtype", dtype);
              params.put("alias", info.getNickName());
              params.put("username", info.getUsername());
              params.put("pwd", info.getPassword());
              EasyHttp.getInstance().postJson(mActivity, getUrl(DEVICE_BIND), params,
                      new EasyCallBack() {
                          @Override
                          public void onSuccess(String result) {
                              DeviceInfo info = FList.getInstance().getDeviceInfoById(did);
                              if (result == null || result.length() == 0 || info == null) {
                                  return;
                              }
                              String data = LoginDataUtils.getData(result);
      ​
                              LocalLogUtil.writeLog(mActivity, "bindDeviceHandler result:" + result);
                              JSONObject jsonData;
                              String sCode = "";
                              String encrypt = "";
                              try {
                                  jsonData = new JSONObject(data);
                                  sCode = jsonData.getString("sCode");
                                  encrypt = jsonData.getString("encrypt");
                              } catch (JSONException e) {
                                  e.printStackTrace();
                              }
                          }
      ​
                          @Override
                          public boolean onFail(int status, String msg) {
                              return true;
                          }
                      });
          }
      

      9.V2 Authentication

      xxxxxxxxxx
      //设备复位绑定
      public short verificationV2(String did, String userName, String password, String attr1, String attr3);
      

      1. Function function description

         • V2 authentication

         • Declaration class

           xxxxxxxxxx
           DevicesManage.java
           

      2. Describe the context (dependent interfaces or used with those interfaces)

         • Support sharing devices. The incoming device identity encryption information is secretstring
         • For devices that support unbinding after resetting, the incoming device authentication information is secretstring

      3. Param

         Param	Details
         did	Device DID
         userName	Device user name
         password	Device password
         attr1	Device authentication key
         attr3	is host."OWN":host，"GUE"：guest

      4. Return

         Return	Details
         action	Constants.Action.RET_AUTHV2
         result	ok：success，failed：failed
         ScodeFailed	Scode is ok，1：Scode is failed
         did	Device DID

      5. Simple sample code

         xxxxxxxxxx
         DevicesManage.getInstance().verificationV2(curDeviceInfo.getDid(), curDeviceInfo.getUsername(), curDeviceInfo.getPassword(), curDeviceInfo.getAttr1(), attr3);
         ​
         ​
         private BroadcastReceiver receiver = new BroadcastReceiver() {
         ​
                 @Override
                 public void onReceive(Context context, Intent intent) {
                     String action = intent.getAction();
                     String did = intent.getStringExtra(ConstantsCore.DID);
                     switch (action) {
                         case Constants.Action.RET_AUTHV2:
                             String result = intent.getStringExtra(ConstantsCore.RESULT);
                             String did = intent.getStringExtra(ConstantsCore.DID);
                             String scodeFailed = intent.getStringExtra("ScodeFailed");
                             break;
                     }
                 }
           };
         ​
         

Get Device List

xxxxxxxxxx
//Get device list
public static String GET_DEVICE_LIST = "/safe/get-device-list/" + SN; // Get device list

1. Function function description

   • Get device list

2. Describe the context (dependent interfaces or used with those interfaces)

   • After V1 authentication is successful, get the device list and get the data of the corresponding did from the device list. First get the encrypt data from the extracted data. If encrypt is not empty, use the encrypt data as the secret string for V2 authentication. If encrypt is empty, use attr1 data. If attr1 is not empty, use attr1 data as the secret string for V2 authentication. If attr1 is also empty, use nothing method for V2 authentication

3. Param

   Param	Details
   sn	Enterprise serial number

4. Return

   Return	Details
   data	Contains entries key value pairs
   code	The return code 200 indicates success
   error	Prompt information

   entries	Details
   id	Device table id
   dtype	Equipment type [1-ipc; 2-nvr; 3-dvr; 4-panorama; 5-alarm box; 6-low power consumption]
   sn	Enterprise serial number
   account	account
   did	Device DID
   pwd	Device password
   alias	Device alias
   username	Device user name
   auth
   attr1	Device authentication key
   attr2	List of functions supported by device sharing
   attr3	Device identity information (empty is the old device; 0 is the master device; other numbers are the guest devices)
   attr5	Multi function field
   createTime
   host	Device owner account information
   shareNumber	Quantity shared
   encrpt	Device verification information
   passwordHint	Prompt to change password (false - no prompt; true - prompt)

   xxxxxxxxxx
   //Example
    
   {
       "code": 200,
       "data": {
           "entries": [{
               "id": 2591515,
               "dtype": "1",
               "sn": null,
               "account": null,
               "did": "IOTDAA-706571-PMKNZ",
               "pwd": "",
               "alias": "706571",
           "username": "admin",
               "auth": null,
               "attr1": "NIN3g5Ot/bY+0INKgwftHJ2yx/2xMmN7",
               "attr2": null,
               "attr3": "0",
               "attr5": {
                   "uuidpush": "IOTDAA-706571-PMKNZ,WZXACQ#WLTBEC",
                   "aiotuiedit": "true",
                   "cloudStoreAbility": "1",
                   "mac": "30:7b:c9:3a:86:a5"
               },
               "createTime": null,
           "host": null,
               "shareNumber": 0,
               "encrypt": "NIN3g5Ot/bY+0INKgwftHDfgxQ1w974KDOo2sHc3/tqp9C7P0AMIE1MrQQOxhwn76vzXdg/ofZ8=",
               "subStatus": null
           }]
       },
       "error": "成功！"
   }
   

5. Simple sample code

   xxxxxxxxxx
       public static void findDevice(Context context, final Handler handler){
           EasyHttp.getInstance().get(context, getUrl(GET_DEVICE_LIST), null, new EasyCallBack() {
               @Override
               public void onSuccess(String result) {
                   String data = LoginDataUtils.getData(result);
                   Message e = handler.obtainMessage();
                   e.what = DeviceAddTypeQRConnActivity.FIND_DEVICE_SUC;
                   Bundle bundle = new Bundle();
                   bundle.putString("device_json", data);
                   e.setData(bundle);
                   handler.sendMessage(e);
               }
   ​
               @Override
               public boolean onFail(int status, String msg) {
                   handler.sendEmptyMessage(DeviceAddTypeQRConnActivity.FIND_DEVICE_FAIL);
                   return true;
               }
           });
       }
   

Equipment distribution network

Device network interface

Get netcard information

xxxxxxxxxx
public short getNetcardInfo(String did)

1. Function function description

   Obtain the network card information of the camera to obtain the network type of the camera and which mode is currently in the STA or AP .

   Declaration class

xxxxxxxxxx
  DevicesManage.java

2. Parameters

4. 返回值

5. sample

   xxxxxxxxxx
   DevicesManage.getInstance().getNetcardInfo(did);
   

    

Get network config

xxxxxxxxxx
public short getNetcfg(String did)

1. Function function description

   Get the network parameters of the camera, including information such as IP address and mac address.

   Declaration class

xxxxxxxxxx
  DevicesManage.java

2. Parameters

4. Return

5. sample

   xxxxxxxxxx
   DevicesManage.getInstance().getNetcfg(did);
   ​
   NetworkVO
   package：com.echosoft.gcd10000.core.entity
   ​
   private String type; //wire ,wireless 
   private String dhcp; //true DHCP 
   private String ip; //IP 
   private String netmask; 
   private String gw; 
   private String mac;
   private String dns1; //main DNSmain
   private String dns2;
   ​
   

Get Wifi information

xxxxxxxxxx
public short getWifiInfo(String did, String mac)

1. Function function description

   Get device Wifi information

   Declaration class

xxxxxxxxxx
  DevicesManage.java

2. Parameters

4. Return

5. Sample

   xxxxxxxxxx
   DevicesManage.getInstance().getWifiInfo(did);
   

Set wifi

xxxxxxxxxx
public short setWifiInfo(String did, String mac, String wifiName, String random, String password);  
public short setWifiInfoV2(String did, String mac, String wifiName, String random, String password);//support chinese ssid

1. Function function description

   Set the camera to connect to the specified wifi

   Declaration class

xxxxxxxxxx
  DevicesManage.java

3. Parameters

4. Return

5. Sample

   xxxxxxxxxx
   String password = random + ":" + wifiPassword;
   //判断是否是Acsii码的WiFi名
   //正则：public static final String REGEX_WIFI_SSID = "^[\\w\\x21-\\x7e]+$";
   if (RegexUtil.isAsciiWifiName(wifiName)) { 
       DevicesManage.getInstance().setWifiInfo(did, mac, wifiName, random, Base64Util.encode(password.getBytes()));
   } else {
       DevicesManage.getInstance().setWifiInfoV2(did, mac, wifiName, random, Base64Util.encode(password.getBytes()));
   }
   

return：

xxxxxxxxxx
private BroadcastReceiver receiver = new BroadcastReceiver() {
    @Override
    public void onReceive(Context context, Intent intent) {
        String action = intent.getAction();
        String did = intent.getStringExtra(ConstantsCore.DID);
        switch (action) {
            case Constants.Action.RET_SET_WIFI_INFO_V2:
            case Constants.Action.RET_SET_WIFI_INFO: {
                if (ConstantsCore.CommandResult.AUTH_SUCCESS.equals(result)) {
                    String retAPmac = intent.getStringExtra("mac");
                    String retSsid = intent.getStringExtra("ssid");
                    String retRandom = intent.getStringExtra("random");
                } else {
            
                }
            }
        }
    }
}; 

####

Set network by QR code

The flow chart is as follows:

Generate QR code

1. Reset device
2. QR code content：

"S="+ssid+"&P="+ pwd +"&T="+rowStr+"&K="+key+"&A="+ipAddress+"+"+ipPort

ssid and pwd need encode by base64 ；delete"/n"

rowStr:timezone different（*60），for example "+480" or negative timezone "480"

key:random string , length 5

ipAddress:uppercase hex LAN ip, for example：192.168.250.199 to C7FAA8C0

ipPort:uppercase hex idle port，forexample：39531 to 6B9A

xxxxxxxxxx
String qrStr = "S=" + ssid
                + "&P=" + pwd
                + "&T=" + rowStr
                + "&K=" + key
                + "&A=" + ipAddress
                + "+" + ipPort;
if (qrStr.contains("\n")) {
    qrStr = qrStr.replace("\n", "");
}
Bitmap netfits = QrCodeUtils.generateBitmap(qrStr, 1000, 1000);
​
public static Bitmap generateBitmap(String content, int width, int height) {
        
        if (TextUtils.isEmpty(content)) {
            return null;
        }
        
        if (width < 0 || height < 0) {
            return null;
        }
​
        HmsBuildBitmapOption options = new HmsBuildBitmapOption.Creator()
                .setBitmapMargin(4)
                .create();
        try {
            return ScanUtil.buildBitmap(content, HmsScan.QRCODE_SCAN_TYPE, width, height, options);
        } catch (WriterException e) {
            e.printStackTrace();
        }
​
        return null;
    }
​

LAN detection equipment

SeeLAN detection equipment

or lib/Include/UDPReceiverUtil.java

Add Device

SeeDevice binding process

Set Network by AP

The flow chart is as follows:

Step of Set Network by Ap

1. reset device

2. record wifi ssid and password

3. connect device ap hotspot start with "ZWAP_", password "01234567",get device did and login device

4. set wifi

   get wireless mac

   DevicesManage.getInstance().getNetcfg()

   get random number

   DevicesManage.getInstance().getWifiInfo()

   set wifi

   DevicesManage.getInstance().setWifiInfo()

add Device

SeeDevice binding process

Preview

Live broadcast

Page Set Monitor for playing video

1.Layout file

xxxxxxxxxx
<com.echosoft.gcd10000.core.device.custom.Monitor 
    android:id="@+id/single_monitor" 
    android:layout_width="match_parent" 
    android:layout_height="match_parent" 
    android:layout_centerInParent="true" />

2.Set did and channel for Monitor

xxxxxxxxxx
monitor.setDID(did);
monitor.setMchannel(channel);

Register video stream data callback

1.method

xxxxxxxxxx
public void regAVListener(String did, int channel, Monitor monitor)

2.parameter

3.example

xxxxxxxxxx
DevicesManage.getInstance().regAVListener(did, channel, iAVListener);

Enable Live Preview

1.method

xxxxxxxxxx
public short openVideoStream(String did, String channel)

2.parameter

3.example

xxxxxxxxxx
  DevicesManage.getInstance().openVideoStream(did, channel);

4.Return value （Broadcast monitoring for callback ConstantsCore.Action.RET_OPENSTREA）

Close Live Preview

1.method

xxxxxxxxxx
public short closeVideoStream(String did, channel)

2.parameter

3.example

xxxxxxxxxx
DevicesManage.getInstance().closeVideoStream(did, channel);

4.Return value （Broadcast monitoring for callback ConstantsCore.Action.RET_CLOSESTREAM）

The specific process of opening the live broadcast

1. Layout the Monitor control on the interface

   xxxxxxxxxx
   <com.echosoft.gcd10000.core.device.custom.Monitor 
       android:id="@+id/single_monitor" 
       android:layout_width="match_parent" 
       android:layout_height="match_parent" 
       android:layout_centerInParent="true" />
   

2. Set did and channel for Monitor

xxxxxxxxxx
    monitor.setDID(did);
    monitor.setMchannel(channel);

3. Register the Monitor callback to enable the Monitor to receive the video stream data of the specific channel of the device

   xxxxxxxxxx
   DevicesManage.getInstance().regAVListener(did, channel, iAVListener);
   

4. Call the stream opening command, and the Monitor starts playing the video.

   xxxxxxxxxx
   DevicesManage.getInstance().openVideoStream(did, channel);
   

5. Send the command to close the video stream, cancel the registration of the monitor, and clear the dids and channels of the monitor

   xxxxxxxxxx
   public synchronized void closeVideoStream(String did, channel)
   monitor.setMchannel(-1);
   monitor.setDID(null);
   

Audio

Turn audio streaming on/off

xxxxxxxxxx
public short openAudioStream(String in_strDID, String iChannel);
public short closeAudioStream(String in_strDID, String iChannel);

1. Function Description

   • Turn audio streaming on/off

2. Describe the context (dependent interfaces or interfaces used together)

   • Only when the real-time preview video stream is enabled

3. parameter

   parameter	directions
   in_strDID	equipment did
   iChannel	equipment channel number，from 0

4. Return value

   • none

5. Simple sample code

   xxxxxxxxxx
    DevicesManage.getInstance().openAudioStream(did, channel);  
    DevicesManage.getInstance().closeAudioStream(did, channel);
   

Audio switch control

xxxxxxxxxx
public void openAudioDecode(String did);
public void closeAudioDecode(String did);

1. Function Description

   • Control audio switch

2. Describe the context (dependent interfaces or interfaces used together)

   • To turn audio streaming on/off first

3. parameter

   parameter	directions
   did	equipment did

4. Return value

   • none

5. Simple sample code

   xxxxxxxxxx
   DevicesManage.getInstance().openAudioDecode(did);
   DevicesManage.getInstance().closeAudioDecode(did);