P6SCoreSDK(iOS)

Contents

• SDK integration
• SDK initialization
• P2P Connection
• Add device process
• Live streaming
• SD card/hard disk playback
• Domestic cloud storage playback
• Device connection network
• Local area network detection
• Basic equipment configuration
• Network Access
• QR Code Network Setup

SDK integration

• Integrated Development Environment

SDK initialization

• Initialization
• Deinitialization

P2P Connection

• P2P ConnectionP2P Connection
• Connect device（P2P）
• Log in device
• Disconnect device
• Get the last online time of the device
• Query the online status of the device on the server

Add device process

• 一、Interface Description
• 二、flow chart
• 三、Flow Description

Live streaming

• Live video playback

• Live Audio Playback

• Live screenshot

• Live video

• Intercom

• Toggle resolution

• PTZ control (PTZ control)

   

SD card/hard disk playback

• Obtain the video information of a certain month
• Obtain the video information of a certain day
• Start playing back
• Setting up the Playback Agent
• Play agent (YUV data callback)
• Play agent (timestamp callback)
• Render YUV data (copy data)
• Render YUV data (set width and height)
• Render YUV data (display video data)
• End Playback
• Playback process
• Audio frequency playback
• Playback audio switch
• Audio decoding switch
• Positioning of playback
• Play back the screenshot
• Double speed playback
• Play back the video
• Video download

Domestic cloud storage playback

• cloud storage initialization

• Cloud storage authentication

• Cloud storage video playback

• Cloud storage audio playback

• Cloud storage playback positioning

• Cloud storage playback screenshot

• Cloud storage playback video

• Cloud storage video download

   

Device connection network

• Scan QR code to connect to the network

• AP connection network

   

Local area network detection

• 1.Local area network detection

Basic equipment configuration

• Acquire equipment capability

• Mirror image Settings

• Time Setting

• Device Information

• Mobile Detection Configuration

• OSD Setting

• Memory card Setting

• Recording Setting

• Human shape detection Setting

• Human tracking Configuration

   

Network Access

• Initialize Network Tools Object
• Select local Servers
• Save token to local

QR Code Network Setup Process Explanation

QR Code Network Setup

• QR Code Network Setup Process Explanation

Low-Power Device

• Setting Low-Power Device Prefix
• Query Online Status for Low-Power Devices on Wake Server
• Query Last Login Time on P2P Server
• Connect to Low-Power Device
• Disconnect Low-Power Device
• Monitor P2P Disconnection Status
• Set AOV Device Flag

SDK integration

Integrated Development Environment

1 Import libP6SCore.a ，libEchoSoftUICore.a， libEchoSoftAPICore.a，libPPCS_API_64.a and P6Score, libEchoSoftUICore，libEchoSoftAPICore，FFmpeg-iOS folder and EchoP2Pclient.h EchoP2Pclient.mm file into the project

2. Import libiconv.tbd，libz.tbd，libc++.tbd，Uikit.framework，Foundation.framework，VideoToolbox.framework

3.Set Enable Testability in the Build settings to No

SDK initialization

Initialization

xxxxxxxxxx
/// Initialization
/**
 *@param userId   use @""
 * @param codeStr1 use @"" 
 * @param codeStr2 use@""
 * @return`
   */
-(BOOL)p2pConnectWithId:(NSString*)userId codeStr1:(NSString*)codeStr1 codeStr2:(NSString*)codeStr2;

1.Function description

• SDK initialization

• Declaration class:

  DevicesManage.h

2.Parameter

3. Return value

   • There is no

4.Simple sample code

xxxxxxxxxx
4.Simple sample code
[[EchoP2PClient sharedP2PClient] p2pConnectWithId:@"" codeStr1:@"" codeStr2:@""];

Deinitialization

xxxxxxxxxx
/**
 * @brief Deinitialize the P2P SDK
 */
-(void) uninitOperate;

1.Function description

• Deinitialize the P2P SDK

• Declaration class:

  DevicesManage.h

2.Parameter:

• There is no

3.Return value:

• There is no

4.Simple sample code:

xxxxxxxxxx
/// Deinitialize
[[EchoP2PClient sharedP2PClient] uninitOperate];

P2P Connection

P2P ConnectionP2P Connection

xxxxxxxxxx
/**
 @brief Detect device P2P connection status
 @param in_strDID Device DID
 @return 0 indicates that the P2P connection is successful, non-zero indicates that the P2P connection fails
 */
-(int) checkStatus:(NSString*) in_strDID;

1. Function description

   • Obtain the connection status of APP and device P2P

   • Declaration class

     xxxxxxxxxx
     DevicesManage.h
     

2. Specify the context (depending on or with which interfaces)

   • Before making a P2P connection with the device, this interface needs to be called to detect the P2P connection status between the APP and the device.

     Usually used with the following functions

     xxxxxxxxxx
     -(void) getContactsState:(NSString *)DID;//Establish a P2P connection with the device
     

3. Parameter

   Parameter	Instructions
   in_strDID	Device DID

4. Return value

   Return value	Instructions
   The connection status of the device（Int）	0 indicates that the P2P connection is successful, non-zero indicates that the P2P connection fails

5. Simple sample code

   xxxxxxxxxx
   int iStatus = [[EchoP2PClient sharedP2PClient] checkStatus:self.contactId];
   

Connect device（P2P）

xxxxxxxxxx
/**
 @brief Establish a P2P connection with the device
 @discusstion Before interacting with the device, it is necessary to establish a P2P connection with the device
 @param DID Device DID
 */
-(void) getContactsState:(NSString *)DID;

1. Function description

   • Establish a P2P connection with the device

   • Declaration class

     xxxxxxxxxx
     DevicesManage.h
     

2. Specify the context (depending on or with which interfaces)

   • Before interacting with the device, a P2P connection must be established with the device. Calling this method allows the APP and the device to perform a P2P connection
   • After calling this method, you need to use the (-(int) checkStatus:(NSString*) in_strDID) method to check whether the P2P connection is successful
   • Interact with the device after detecting the successful P2P connection

3. Parameter

   Parameter	Instructions
   DID	Device DID

4. Return value

   • There is no

5. Simple sample code

   xxxxxxxxxx
   [[EchoP2PClient sharedP2PClient] getContactsState:did];
   

Log in device

Common equipment

xxxxxxxxxx
/**
 Send password verification
 @param in_strDID Device did
 @param strUserName device account
 @param strUserpassword device password
 */
-(void) sendAuth:(NSString*) in_strDID withUserName:(NSString*)strUserName withUserpassword:(NSString*)strUserpassword;

1. Function description

   • Log in to the device and authenticate (device without sharing)

   • Declaration class

     xxxxxxxxxx
     DevicesManage.h
     

2. Explain the context relationship (depending on the interface or which interfaces are used with it)

   • The APP interacts with the device. After the APP and the device successfully establish a P2P connection, you need to log in to the device
   • Devices without sharing use this interface to log in to the device

3. Parameter

   Parameter	Instructions
   in_strDID	Device DID
   strUserName	username
   strUserpassword	password

    

4. Return value（notification return code：RET_VALIDATION_PASSWORD）

   Return value	Instructions
   AutoBind	Whether to support reset unbinding, 0: not supported, 1: supported
   DeviceShared	Whether to support sharing, 0: not supported, 1: supported
   auth	ok: authentication succeeded, failed: authentication failed
   authContactId	device did
   did	device did
   is_pwd_correct	Whether the device password is correct, 0: wrong, 1: correct (only some devices support)
   key	command number
   result	ok: authentication succeeded, failed: authentication failed

5. Simple sample code

   xxxxxxxxxx
   [[EchoP2PClient sharedP2PClient] sendAuth:did withUserName:username withUserpassword:password];
   

Share device

xxxxxxxxxx
/**
 Send password verification (for shared devices, pass in the secretString of the owner or visitor)
 @param in_strDID device did
 @param strUserName device account
 @param strUserpassword device password
 @param secretString Secret key (obtained from the bonded device or become the master interface)
 @param isOWN Is it the master
 */
-(void) sendAuthV2:(NSString*) in_strDID withUserName:(NSString*)strUserName withUserpassword:(NSString*)strUserpassword withSecretString:(NSString *)secretString isOWN:(BOOL)isOWN;

1. Function Description

   • Log in to the device and authenticate (device sharing)

   • Declaration class

     xxxxxxxxxx
     DevicesManage.h
     

2. Explain the context relationship (depending on the interface or which interfaces are used with it)

   • All devices need to perform V1 authentication after the P2P connection is successful, and then judge whether V2 authentication is required according to the result of V1 authentication

     xxxxxxxxxx
     ///V1 authentication interface
     -(void) sendAuth:(NSString*) in_strDID withUserName:(NSString*)strUserName withUserpassword:(NSString*)strUserpassword;
     

   • If the V1 authentication interface returns AutoBind as 1 (supports reset unbinding) or DeviceShared is 1 (supports sharing), you need to call the V2 authentication interface

3. Parameter

   Parameter	Instructions
   in_strDID	device did
   strUserName	device account
   strUserpassword	device password
   secretString	Device authentication key Obtain the device list after logging in to the device, and obtain the value corresponding to the encrpt field as secretString. If encrpt is empty, use the value of the attr1 field as secretString
   isOWN	Whether it is the owner (share and reset the unbound device, there is a relationship between the owner and the guest, if it is the owner, pass YES, and NO is the guest)

4. Return value（notification return code：RET_VALIDATION_PASSWORDV2）

   Return value	Instructions
   key	command number
   result	ok: authentication succeeded, failed: authentication failed
   DeviceShared	Whether to support sharing, 0: not supported, 1: supported
   auth	ok: authentication succeeded, failed: authentication failed
   authContactId	device did
   did	device did

5. Simple sample code

   xxxxxxxxxx
   [[EchoP2PClient sharedP2PClient] sendAuthV2:self.did withUserName:username withUserpassword:password withSecretString:key isOWN:YES];
   

Disconnect device

xxxxxxxxxx
/**
 @brief Close P2P connection
 @param in_strDID device DID
 */
- (void)closeConnect:(NSString *)in_strDID;

1. Function Description

   • Close P2P connection

   • Declaration class

     xxxxxxxxxx
     DevicesManage.h
     

2. Explain the context relationship (depending on the interface or which interfaces are used with it)

   • Disconnect the P2P connection of the device

3. Parameter

   Parameter	Instructions
   in_strDID	device DID

    

4. Return value

   • There is no

5. Simple sample code

   xxxxxxxxxx
   [[EchoP2PClient sharedP2PClient] closeConnect:cont.contactId];
   

Get the last online time of the device

xxxxxxxxxx
/**
 @brief Query the time when the device is offline
 @param in_strDID Device DID
 @return Returns the time interval (in seconds) from the current offline distance, using the current timestamp - return = offline timestamp
 */
- (int)getDeviceLastTimeWithDID:(NSString *)in_strDID;

1. Function Description

   • Returns the time the device was last online

   • Declaration class

     xxxxxxxxxx
     DevicesManage.h
     

2. Explain the context relationship (depending on the interface or which interfaces are used with it)

   • The last online time of the device can be obtained

3. Parameter

   Parameter	Instructions
   in_strDID	Device DID

4. Return value

   Return value	Instructions
   The number of seconds since the device was last online from the current timestamp	Use the current timestamp - return value = offline timestamp (-1: the device has never been online or was online 1 year ago, 0: means the device was just online)

5. Simple sample code

   xxxxxxxxxx
   int ret =  [EchoP2PClient.sharedP2PClient getDeviceLastTimeWithDID:DID];
   

Query the online status of the device on the server

xxxxxxxxxx
/**
 @brief Query the online status of the device on the server
 @param DIDString Device DID
 @param onlineStatuCallback Device state callback
 void(^)(int queryResult, NSString *DID)
 @param queryResult device status >0 device online -6 device offline -3 query timeout
 @param DID Device DID
 */
- (void)queryDeviceOnlineStatuWithDID:(NSString *)DIDString callback:(void(^)(int queryResult, NSString *DID))onlineStatuCallback;

1. Function description

   • Query the online status of the device on the server

   • Declaration class

     xxxxxxxxxx
     DevicesManage.h
     

2. Explain the context relationship (depending on the interface or which interfaces are used with it)

   • Query the online status of the device on the server

   • Generally, first query the online status of the device on the server

     • When the device is online, establish a P2P connection with the device

       xxxxxxxxxx
       -(void) getContactsState:(NSString *)DID;//Establish a P2P connection with the device
       

   • • If the device is not online, get the offline time of the device

       xxxxxxxxxx
       - (int)getDeviceLastTimeWithDID:(NSString *)in_strDID;
       

        

3. Parameter

   Parameter	Instructions
   DIDString	Device DID
   onlineStatuCallback	Device state callback
   	queryResult device status >0 device online -6 device offline -3 query timeout
   	DID Device DID

4. Return value

   • There is no

5. Simple sample code

   xxxxxxxxxx
   [EchoP2PClient.sharedP2PClient queryDeviceOnlineStatuWithDID:array[0] callback:^(int queryResult, NSString *DID) {
   }];
   

Add device process

一、Interface Description

P2P connection

xxxxxxxxxx
//P2P connected devices
-(void)getContactsState:(NSString *)DID;

1. Function Description

   • Connect device

   • Declaration class

     xxxxxxxxxx
     EchoP2PClient.h
     

2. Describe contextual relationships (depending on interfaces or working with those interfaces)

   • All device operations can only be called after the P2P connection is successful

3. Parameter

   Parameter	Instructions
   DID	Device did

4. Return value

   • There is no

5. Simple sample code

   xxxxxxxxxx
   [[EchoP2PClient sharedP2PClient] getContactsState:did];
   

Get device information

xxxxxxxxxx
//Get device information
- (void)sendDeviceInfo:(NSString*)in_strDID

1. Function Description

   • Get device information

   • Declaration class

     xxxxxxxxxx
     EchoP2PClient.h
     

2. Describe contextual relationships (depending on interfaces or working with those interfaces)

   • Called after the device is connected to P2P

3. Parameter

   Parameter	Instructions
   in_strDID	Device did

4. Return value

   Return value	Instructions
   ID	Device did (this field is commonly used)
   dwSrcID	Device did
   Key	command number
   model	Device model
   version	Device version number
   resultDic	dictionary

   resultDic key value	Instructions
   channel	Total number of channels
   dev_type	Device type, such as: IPC, NVR, HVR, etc.
   limit
   mac	mac address (this field is invalid and must be obtained through other interfaces)
   serial_no	serial number
   verdor
   zwp2p_ver	zwp2p protocol version

5. Simple sample code

   xxxxxxxxxx
   [[EchoP2PClient sharedP2PClient] sendDeviceInfo:did];
   

V1 authentication

xxxxxxxxxx
//V1 authentication
- (void)sendAuth:(NSString*)in_strDID withUserName:(NSString*)strUserName withUserpassword:(NSString*)strUserpassword

1. Function Description

   • The device performs V1 authentication

   • Declaration class

     xxxxxxxxxx
     EchoP2PClient.h
     

2. Describe contextual relationships (depending on interfaces or working with those interfaces)

   • Called after the device is connected to P2P

3. Parameter

   Parameter	Instructions
   in_strDID	device did
   strUserName	device username
   strUserpassword	device password

4. Return value（notification return code：RET_VALIDATION_PASSWORD）

   Return value	Instructions
   AutoBind	Whether to support reset unbinding, 0: not supported, 1: supported
   DeviceShared	Whether to support sharing, 0: not supported, 1: supported
   auth	ok: authentication succeeded, failed: authentication failed
   authContactId	device did
   did	device did
   is_pwd_correct	Whether the device password is correct, 0: wrong, 1: correct (only some devices support)
   key	command number
   result	ok: authentication succeeded, failed: authentication failed

5. Simple sample code

   xxxxxxxxxx
   [[EchoP2PClient sharedP2PClient] sendAuth:did withUserName:username withUserpassword:password];
   

Query the device owner

xxxxxxxxxx
//Query the status of the master
static NSString *const kCheckDeviceHostUrlPath = @"safe/get-device-host-status";

1. Function Description

   • Query the status of the device owner

2. Describe contextual relationships (depending on interfaces or working with those interfaces)

   • GET request, query whether the device has an owner, if there is an owner, the device cannot be added, if there is no owner, it needs to become the owner

3. Parameter

   Parameter	Instructions
   did	Device DID

4. Return value

   Return value	Instructions
   code	return code 200 means success
   data	dictionary
   error	prompt information

   Return value	Instructions
   status	1-Currently has master information (the current database has master information but does not match the master Parameters; the peer database has no master information) 2-The peer has master information (the current database has no master information, but the peer database has this master information) 3- No owner information (the current database has no owner information, and the peer database has no owner information) 4- I am the owner (the current database has owner information and the account matches)
   did	device did

   xxxxxxxxxx
   //return value example
   {
       code = 200;
       data =     {
           did = "IOTBBB-685146-HNDLB";
           status = 4;
       };
       error = "\U6210\U529f\Uff01";
   }
   

5. Simple sample code

   xxxxxxxxxx
   [NetManager.sharedManager publicRequestWithActionPath:[NSString stringWithFormat:@"%@?did=%@",kCheckDeviceHostUrlPath,_did] Parameter:nil withMethod:@"GET" callBack:^(id JSON) {
           P6SResult *r = (P6SResult *)JSON;
           if (r.m_iCode == 200) {
               NSDictionary *data = (NSDictionary *)r.m_strData;
               int status = [data[@"status"] intValue];
               if (status == 3) {
                   [weakSelf bindDevice:@""];
               }else {
                   [SVProgressHUD showWithStatus:@"Device is bound"];
                   [SVProgressHUD dismissWithDelay:1];
               }
           }else {
               [SVProgressHUD showErrorWithStatus:r.m_strError];
           }
           } failure:^(NSError *error) {
               NSLog(@"error %@",error);
           }];
   

Add device to user device list

xxxxxxxxxx
//add device
static NSString *const kAddDeviceUrlPath = @"safe/add-device";

1. Function Description

   • Add device to user list

2. Describe contextual relationships (depending on interfaces or working with those interfaces)

   • Before the device is bound, it must be added to the user device list. Devices that do not support sharing or reset unbinding do not need to be bound

3. Parameter

   Parameter	Instructions
   did	device did
   sn	Enterprise serial number
   alias	device alias

4. Return value

   Return value	Instructions
   data	When the code is 200, return the added device table id
   code	return code 200 means success
   error	prompt information

   xxxxxxxxxx
   //return value example
   {
       code = 200;
       data = 2553182;
       error = "\U6210\U529f\Uff01";
   }
   

5. Simple sample code

   xxxxxxxxxx
   NSMutableDictionary *dict = [NSMutableDictionary dictionaryWithDictionary:@{@"alias":@"test",@"did":_did,@"sn":NetManager.sharedManager.m_strCompnySn}];
       [NetManager.sharedManager publicRequestWithActionPath:kAddDeviceUrlPath Parameter:dict withMethod:@"POST" callBack:^(id JSON) {
           P6SResult *r = (P6SResult *)JSON;
           if (r.m_iCode == 200) {
               if ([scode isEqualToString:@""]) {
                   if (weakSelf.deviceType == 1) {
                       [weakSelf bindDevice1];
                   }else if (weakSelf.deviceType == 2) {
                       [weakSelf bindDevice2];
                   }
               }else {
                   [weakSelf unbindDevice:scode];
               }
           }else {
               [SVProgressHUD showErrorWithStatus:r.m_strError];
           }
           } failure:^(NSError *error) {
               NSLog(@"error %@",error);
           }];
   

Get device Scode code

xxxxxxxxxx
//Get Scode
@"GET /System/DeviceBindConfig"

1. Function Description

   • Get device Scode code

   • Declaration class

     xxxxxxxxxx
     EchoP2PClient.h
     

2. Describe contextual relationships (depending on interfaces or working with those interfaces)

   • Devices that support reset and unbinding only have Scode codes, and devices that can obtain Scode codes need to be unbound first
   • The data returned by the device is all xml text, which needs to be converted into key-value pairs by itself

3. Parameter

   Parameter	Instructions
   did	Device did

4. Return value（notification return code：RET_HTTP_API）

   Return value	Instructions
   SCodeVaild	true: with Scode, false: without Scode
   SCode	When SCodeValid is true, you can get the Scode code
   __name	command name

   xxxxxxxxxx
   //Returned resultDic data
   {
       DID = "IOTBBB-685146-HNDLB";
       commandSeq = 9;
       key = 902;
       result = "HTTP/1.0 200 OK
   \nServer: CGI/0.1.0
   \nContent-Length:142
   \nContent-Type:application/xml
   \nConnection:close
   \n
   \n<?xml version=\"1.0\" encoding=\"UTF-8\" ?>\n<DeviceBindConfig Version=\"1.0\">\n    <SCodeValid>false</SCodeValid>\n    <SCode />\n</DeviceBindConfig>\n";
   }
   //Returned resultDic data
   NSString *dataStr = [[resultDic[@"result"] componentsSeparatedByString:@"\r\n\r\n"] lastObject];
   NSMutableDictionary *dic = [NSMutableDictionary dictionaryWithDictionary:[NSDictionary dictionaryWithXMLString:dataStr]];
   
   //dic
   {
       SCodeValid = false;
       "_Version" = "1.0";
       "__name" = DeviceBindConfig;
   }
     
   //logic processing
   if ([dic[@"__name"] isEqualToString:@"DeviceBindConfig"]){
     if (dic[@"SCodeValid"] isEqualToString:@"fasle") {
       
     }
   }
   

5. Simple sample code

   xxxxxxxxxx
   [[EchoP2PClient sharedP2PClient] sendHTTP:did Method:@"GET /System/DeviceBindConfig" param:nil];
   

Upload device Scode code

xxxxxxxxxx
// Upload  Scode
@"PUT /System/DeviceBindConfig"

1. Function description

   • Upload device Scode code

   • Declaration class

     xxxxxxxxxx
     EchoP2PClient.h
     

2. Describe contextual relationships (depending on interfaces or working with those interfaces)

   • Devices that support reset and unbind get a new Scode code after binding, upload it to the device, and do V2 authentication after the upload is successful
   • What needs to be uploaded to the device is xml text

3. Parameter

   Parameter	Instructions
   SCode	Scode

4. Return value（notification return code：RET_HTTP_API）

   Return value	Instructions
   __name	Unified return ResponseStatus of PUT command
   requestURL	requested URL
   statusCode	Status code, 0 The request is successful

   xxxxxxxxxx
   //Returned resultDic data
   {
       DID = "NGLSPE-368863-SBXNE";
       commandSeq = 14;
       key = 902;
       result = "HTTP/1.0 200 OK
   \nServer: CGI/0.94.14rc21
   \nContent-Type: application/xml
   \nConnection: close
   \nContent-Length: 174
   \n
   \n<?xml version=\"1.0\" encoding=\"UTF-8\" ?>\n<ResponseStatus Version=\"1.0\">\n    <requestURL>/System/DeviceBindConfig</requestURL>\n    <statusCode>0</statusCode>\n</ResponseStatus>\n";
   }
   
   //resultDic data processing
   NSString *dataStr = [[resultDic[@"result"] componentsSeparatedByString:@"\r\n\r\n"] lastObject];
   NSMutableDictionary *dic = [NSMutableDictionary dictionaryWithDictionary:[NSDictionary dictionaryWithXMLString:dataStr]];
   
   //dic
   {
       "_Version" = "1.0";
       "__name" = ResponseStatus;
       requestURL = "/System/DeviceBindConfig";
       statusCode = 0;
   }
   
   //logic processing
   if ([dic[@"__name"] isEqualToString:@"ResponseStatus"]){
     if (dic[@"requestURL"] isEqualToString:@"/System/DeviceBindConfig") {
       
     }
   }
   

5. Simple sample code

   xxxxxxxxxx
   NSString *xmlStr=[NSString stringWithFormat:@"<DeviceBindConfig>\n   <SCode>%@</SCode>\n</DeviceBindConfig>",scode];
   [[EchoP2PClient sharedP2PClient] sendHTTP:weakSelf.did Method:@"PUT /System/DeviceBindConfig" param:xmlStr ];
   

Unbind the device

xxxxxxxxxx
//Device reset unbind
static NSString *const kDeviceUnbindUrlPath = @"safe/device-unbind";

1. Function Description

   • Device reset unbind

2. Describe contextual relationships (depending on interfaces or working with those interfaces)

   • When a device that supports reset and unbinding can obtain the Scode code, it must first unbind the device

3. Parameter

   Parameter	Instructions
   did	Device did
   sCode	Device Scode

4. Return value

   xxxxxxxxxx
   //return value example
   {
       code = 200;
       data = "<null>";
       error = "\U6210\U529f\Uff01";
   }
   

5. Simple sample code

   xxxxxxxxxx
   NSMutableDictionary *dic = [NSMutableDictionary dictionaryWithDictionary:@{@"sCode":scode,@"did":_did}];
       [NetManager.sharedManager publicRequestWithActionPath:kDeviceUnbindUrlPath Parameter:dic withMethod:@"POST" callBack:^(id JSON) {
           P6SResult *r = (P6SResult *)JSON;
           if (r.m_iCode == 200) {
               [weakSelf bindDevice2];
           }
           } failure:^(NSError *error) {
               
           }];
   

Only supports shared device binding

xxxxxxxxxx
//become the master
static NSString *const kAddHostUrlPath = @"safe/device-to-host";

1. Function description

   • Support shared device binding

2. Describe contextual relationships (depending on interfaces or working with those interfaces)

   • Devices that only support sharing are bound to become masters differently from devices that support reset and unbind
   • Unbound devices that support reset must support sharing
   • Do V2 authentication directly after becoming the master

3. Parameter

   Parameter	Instructions
   did	device did
   sn	Enterprise serial number

4. Return value

   Return value	Instructions
   data	Device identity encryption information
   code	return code 200 means success
   error	prompt information

   xxxxxxxxxx
   //return value example
   {
       code = 200;
       data = "SMjOwVRLRHr/5Ct+yG/q655hpOoyShhszVNSL1ll7TaJl8LniWGMMJ/QyTatjNn0IqpqvXMAYQs=";;
       error = "\U6210\U529f\Uff01";
   }
   

5. Simple sample code

   xxxxxxxxxx
   NSMutableDictionary *dic = [NSMutableDictionary dictionaryWithDictionary:@{@"sn":NetManager.sharedManager.m_strCompnySn,@"did":_did}];
       [NetManager.sharedManager publicRequestWithActionPath:kAddHostUrlPath Parameter:dic withMethod:@"POST" callBack:^(id JSON) {
           P6SResult *r = (P6SResult *)JSON;
           if (r.m_iCode == 200) {
               NSString *key = r.m_strData;
               [weakSelf authV2:key];
           }
           } failure:^(NSError *error) {
               
           }];
   

Device binding that supports reset unbinding

xxxxxxxxxx
//Device reset binding
static NSString *const kBindDeviceUrlPath = @"safe/device-bind";

1. Function Description

   • Support sharing and reset unbound device binding

2. Describe contextual relationships (depending on interfaces or working with those interfaces)

   • Devices that only support sharing are bound to become masters differently from devices that support reset and unbind
   • Unbound devices that support reset must support sharing
   • After becoming the owner, you need to get the Scode code of the server and upload it to the device. After the upload is successful, do V2 authentication

3. Parameter

   Parameter	Instructions
   did	Device did
   sn	Enterprise serial number

4. Return value

   Return value	Instructions
   code	return code 200 means success
   data	key value pair
   error	prompt information

   data key-value pair	Instructions
   sCode	Unbind the scode used
   encrypt	Device authentication information
   id	device table id

   xxxxxxxxxx
   //return value example
   {
       code = 200;
       data =     {
           encrypt = "SMjOwVRLRHr/5Ct+yG/q655hpOoyShhszVNSL1ll7TaJl8LniWGMMJ/QyTatjNn0IqpqvXMAYQs=";
           id = 2553182;
           sCode = "164938234123568514602102-0400000";
       };
       error = "\U6210\U529f\Uff01";
   }
   

5. Simple sample code

   xxxxxxxxxx
   NSMutableDictionary *dic = [NSMutableDictionary dictionaryWithDictionary:@{@"sn":NetManager.sharedManager.m_strCompnySn,@"did":_did}];
       [NetManager.sharedManager publicRequestWithActionPath:kBindDeviceUrlPath Parameter:dic withMethod:@"POST" callBack:^(id JSON) {
           P6SResult *r = (P6SResult *)JSON;
           NSLog(@"data======%@",r.m_strData);
           if (r.m_iCode == 200) {
               NSDictionary *data = (NSDictionary *)r.m_strData;
               NSString *scode = data[@"sCode"];
               NSString *xmlStr=[NSString stringWithFormat:@"<DeviceBindConfig>\n   <SCode>%@</SCode>\n</DeviceBindConfig>",scode];
               [[EchoP2PClient sharedP2PClient] sendHTTP:weakSelf.did Method:@"PUT /System/DeviceBindConfig" param:xmlStr ];
               [EchoP2PClient sharedP2PClient].putDeviceBindConfigCallBack = ^(NSString *did, NSString *resultDict) {
                   NSString *key = data[@"encrypt"];
                   [weakSelf authV2:key];
               };
           }
           } failure:^(NSError *error) {
               
           }];
   

V2 authentication

xxxxxxxxxx
//Device reset binding
- (void)sendAuthV2:(NSString*) in_strDID withUserName:(NSString*)strUserName withUserpassword:(NSString*)strUserpassword withSecretString:(NSString *)secretString isOWN:(BOOL)isOWN

1. Function description

   • V2 authentication

   • Declaration class

     xxxxxxxxxx
     EchoP2PClient.h
     

2. Describe contextual relationships (depending on interfaces or working with those interfaces）

   • The device identity encryption information passed in by the sharing device is supported as secretString
   • The device authentication information passed in by the unbound device that supports reset is secretString

3. Parameter

   Parameter	Instructions
   in_strDID	Device did
   strUserName	device username
   strUserpassword	device password
   secretString	Device authentication key
   isOWN	Is it the master

4. Return value（notification return code：RET_VALIDATION_PASSWORDV2）

   Return value	Instructions
   key	command number
   result	ok: authentication succeeded, failed: authentication failed
   DeviceShared	Whether to support sharing, 0: not supported, 1: supported
   auth	ok: authentication succeeded, failed: authentication failed
   authContactId	device did
   did	device did

5. Simple sample code

   xxxxxxxxxx
   [[EchoP2PClient sharedP2PClient] sendAuthV2:self.did withUserName:username withUserpassword:password withSecretString:key isOWN:YES];
   

Get device list

xxxxxxxxxx
//Get device list
static NSString *const kGetDeviceListUrlPath = @"safe/get-device-list";

1. Function description

   • Get device list

2. Describe contextual relationships (depending on interfaces or working with those interfaces)

   • After the V1 authentication is successful, go to get the device list, get the data corresponding to did from the device list, first get the encrypt data from the extracted data, if encrypt is not empty, use the encrypt data as secretString for V2 authentication, If encrypt is empty, attr1 data will be taken later, if attr1 is not empty, attr1 data will be used as secretString for V2 authentication, if attr1 is also empty, V2 authentication cannot be performed

3. Parameter

   Parameter	Instructions
   sn	Enterprise serial number

4. Return value (entries key-value pair)

   Return	Instructions
   data	Contains entries key-value pairs
   code	return code 200 means success
   error	prompt information

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

   xxxxxxxxxx
   //return value example
   {
       code = 200;
       data =     {
           entries =         (
                           {
                   account = "<null>";
                   alias = test;
                   attr1 = "SMjOwVRLRHr/5Ct+yG/q6yuImWMh2XIa";
                   attr2 = "<null>";
                   attr3 = 0;
                   attr5 =                 {
                       aiotuiedit = false;
                       cloudStoreAbility = 1;
                       deviceinfotype = "ewogICJ2ZXJkb3IiIDogInp3IiwKICAic2VyaWFsX25vIiA6ICJJMjA3RjE0MTM3MTExMkE2MUIyMkI1RSIsCiAgImNoYW5uZWwiIDogIjEiLAogICJtYWMiIDogIiIsCiAgImRldl90eXBlIiA6ICJJUENfUiIsCiAgIm1vZGVsIiA6ICJTODM0XC81NTIwUEhSLUFJIiwKICAibGltaXQiIDogIiIsCiAgInp3cDJwX3ZlciIgOiAiVjIuMi40LjgzMTUiLAogICJ2ZXJzaW9uIiA6ICIxLjEuOS0yMDIwMDkwOVoxUyIKfQ==";
                       mac = "7c:a7:b0:ff:23:64";
                       uuidpush = "IOTBBB-685146-HNDLB,PRUYFI#AYYTBU";
                   };
                   auth = "<null>";
                   createTime = "<null>";
                   did = "IOTBBB-685146-HNDLB";
                   dtype = 1;
                   encrypt = "SMjOwVRLRHr/5Ct+yG/q655hpOoyShhsHUO6hG+uqGs5PxDxDZ66NTUZh8h3j69EIqpqvXMAYQs=";
                   host = "<null>";
                   id = 2552044;
                   pwd = "";
                   shareNumber = 0;
                   sn = "<null>";
                   subStatus = "<null>";
                   username = "<null>";
               }
           );
       };
       error = "\U6210\U529f\Uff01";
   }
   

    

5. Simple sample code

   xxxxxxxxxx
   [NetManager.sharedManager publicRequestWithActionPath:[NSString stringWithFormat:@"%@/%@",kGetDeviceListUrlPath,NetManager.sharedManager.m_strCompnySn] Parameter:nil withMethod:@"GET" callBack:^(id JSON) {
           NSLog(@"json===%@",JSON);
           P6SResult *r = (P6SResult *)JSON;
           if (r.m_iCode == 200) {
               NSDictionary *data = (NSDictionary *)r.m_strData;
               NSLog(@"data===%@",data);
               NSArray *entries = data[@"entries"];
               if (entries.count != 0) {
                   NSDictionary *dict = entries[0];
                   if ([weakSelf isNullString:dict str:@"encrypt"]) {
                       [weakSelf authV2:dict[@"encrypt"]];
                   }else if ([weakSelf isNullString:dict str:@"attr1"]) {
                       [weakSelf authV2:dict[@"attr1"]];
                   }
               }
           }else {
               [SVProgressHUD showErrorWithStatus:[NSString stringWithFormat:@"%d",r.m_iCode]];
               [SVProgressHUD dismissWithDelay:1];
           }
       } failure:^(NSError *error) {
           NSLog(@"error %@",error);
       }];
   

二、flow chart

三、Flow Description

• First, connect the device. After success, obtain device information and perform V1 authentication; obtain device information to know whether the device supports sharing or support reset and unbinding; after V1 authentication is successful, you can obtain the device list to determine whether V2 authentication can be performed. If the V2 authentication is successful, it means that the binding has been successful, otherwise proceed to the following process
• For devices that support sharing, you can query the device owner. If there is an owner, you cannot add the device; if there is no owner, you can become the owner by sharing the device, and then do V2 authentication.
• For a device that supports reset and unbinding, first obtain the Scode code; when the Scode code is obtained, unbind the device, then re-bind the device, obtain the Scode code from the server and upload it to the device for V2 authentication. When the Scode code cannot be obtained, query the owner; if there is an owner, the device cannot be added; if there is no owner, bind the new device according to the method of reset and unbind, obtain the Scode code from the server and upload it to the device, and perform V2 authentication

Live streaming

Live video playback

Set playback proxy

xxxxxxxxxx
/**
  @brief Set playback proxy
  @param delegateCamera Proxy object
  @param delegateCamera device
 */
-(void)setDelegateCamera:(NSString*)in_strDID withDelegateCamera:(id <DelegateCamera>) delegateCamera;

1. Function description

   • Set the playback agent to recall the decoded data to the upper layer

   • Declaration class

     xxxxxxxxxx
     EchoP2PClient.h
     

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

   • use（-(void) sendOpenStream:(NSString*) in_strDID withChannel:(int)iChannel withQuality:(int)iQuality;）The proxy method must be set first

   • The following proxy methods are usually used

     xxxxxxxxxx
     - (void) refreshFrame:(uint8_t *)pFrameYUVData withVideoWidth:(NSInteger)width videoHeight:(NSInteger)height withObj:(NSObject *)obj withChannel:(int)iChannel withDid:(NSString*)strDid isPlayBack:(BOOL)isPlayBack codeRate:(int)codeRate
     

3. Parameter

   Parameter	Explain
   delegateCamera	The proxy object complies with the Delegatecamera agreement
   in_strDID	Device did

4. Return value

   • none

5. Simple sample code

   xxxxxxxxxx
   [[EchoP2PClient sharedP2PClient] setDelegateCamera:_did withDelegateCamera:self];
   

Playback agent (YUV data callback)

xxxxxxxxxx
/**
 @brief Get the data of YUV after decoding
 @param Pframeyuvdata decoded YUV data
 @param width Width of video
 @param height Video height
 @param obj Not currently used
 @param iChannel Device channel number
 @param strDid Device did
*/
- (void) refreshFrame:(uint8_t *)pFrameYUVData withVideoWidth:(NSInteger)width videoHeight:(NSInteger)height withObj:(NSObject *)obj withChannel:(int)iChannel withDid:(NSString*)strDid;

1. Function description

   • Video playback proxy method

   • Declaration class

     xxxxxxxxxx
     DelegateCamera.h
     

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

   • This agent will be used for all video playback
   • This agent throws the decoded YUV data to the application layer

3. Parameter

   Parameter	Explain
   pFrameYUVData	Decoded YUV data
   width	Width of video
   height	Video height
   obj	Not currently used
   iChannel	Device channel number starts from 0
   strDid	Device did number

4. Return value

   • none

5. Simple sample code

   xxxxxxxxxx
   - (void) refreshFrame:(uint8_t *)pFrameYUVData withVideoWidth:(NSInteger)width videoHeight:(NSInteger)height withObj:(NSObject *)obj withChannel:(int)iChannel withDid:(NSString*)strDid{
     
   }
   

Render YUV data (set width and height)

xxxxxxxxxx
- (void)copyYUV420pData:(void *)data width:(NSInteger)w height:(NSInteger)h;

1. Function description

   • Set the width and height of the playback video

   • Declaration class

     xxxxxxxxxx
     OpenGLView20.h
     

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

   • Usually, it is used together with rendering copy data, setting width and height, and displaying video data
   • In the proxy method of playing proxy and recalling video decoding YUV, render the data of playing YUV
   • First copy the YUV data, then set the width and height of the playback view, and finally play the display video data

3. Parameter

   Parameter	Explain
   w	Width of video
   h	Video height
   data	Decoded YUV data (pFrameYUVData in the playback agent is passed here)

4. Return value

   • none

5. Simple sample code

   xxxxxxxxxx
   [self.pbVideoView copyYUV420pData:pFrameYUVData width:width height:height];
   [self.pbVideoView setVideoSize:width height:height];
   [self.pbVideoView displayYUV420pData:nil width:width height:height];
   

Render YUV data (display video data)

xxxxxxxxxx
- (void)displayYUV420pData:(void *)data width:(NSInteger)w height:(NSInteger)h;

1. Function description

   • Display video data on the playback view

   • Declaration class

     xxxxxxxxxx
     OpenGLView20.h
     

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

   • Usually, it is used together with rendering copy data, setting width and height, and displaying video data
   • In the proxy method of playing proxy and recalling video decoding YUV, render the data of playing YUV
   • First copy the YUV data, then set the width and height of the playback view, and finally play the display video data

3. Parameter

   Parameter	Explain
   data	Call the - (void) copyyuv420pdata: (void *) data width: (nsinteger) w height: (nsinteger) h method to copy the data, and then pass it here to nil
   w	Width of video
   h	Video height

4. Return value

   • none

5. Simple sample code

   xxxxxxxxxx
   [self.pbVideoView copyYUV420pData:pFrameYUVData width:width height:height];
   [self.pbVideoView setVideoSize:width height:height];
   [self.pbVideoView displayYUV420pData:nil width:width height:height];
   

End playback

xxxxxxxxxx
/**
  @brief End playback
  @param in_strDID Device did
  @param iChannel Device channel number
 */
- (int)sendCloseStream:(NSString*)in_strDID withChannel:(int)iChannel

1. Function description

   • End playback

   • Declaration class

     xxxxxxxxxx
     EchoP2PClient.h
     

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

   • This method is usually called to close playback when the playback ends or when the playback interface jumps out

3. Parameter

   Parameter	Explain
   DID	DID DID of the device
   iChannel	Channel number, starting from 0

4. Return value

   • none

5. Simple sample code

   xxxxxxxxxx
   [[EchoP2PClient sharedP2PClient] sendCloseStream:did withChannel:channelNumber];
   

Playback process

1. Set playback proxy
2. Start playing
3. Render video with OpenGLView20
4. Turn off playback

Live Audio Playback

Turn on/off audio

xxxxxxxxxx
/**
 @brief Turn on/off the audio function, used in conjunction with setting the sound playback switch and audio decoding
 @code
 [[EchoP2PClient sharedP2PClient] sendCloseAudio:_did withChannel:_channelNumber];
 [[EchoP2PClient sharedP2PClient] setPlayAudioSwitch:NO];
 [[EchoP2PClient sharedP2PClient] setPlayStreamAudioSwitch:NO];
 
 [[EchoP2PClient sharedP2PClient] sendOpenAudio:_did withChannel:_channelNumber];
 [[EchoP2PClient sharedP2PClient] setPlayAudioSwitch:YES];
 [[EchoP2PClient sharedP2PClient] setPlayStreamAudioSwitch:YES];
 @endcode
 */
//turn on audio
-(void)sendOpenAudio:(NSString*)in_strDID withChannel:(int)iChannel
//turn off audio
-(void)sendCloseAudio:(NSString*)in_strDID withChannel:(int)iChannel

1. Function Description

   • Turn on/off the audio function

   • declaration class

     xxxxxxxxxx
     EchoP2PClient.h
     

2. Explain the context relationship (depending on the interface or which interfaces are used with it)

   • Turn on/off the audio function first, then turn on/off the audio switch, and finally turn on/off the audio decoding

3. Parameter

   Parameter	Explain
   in_strDID	Device did
   iChannel	Channel number, starting from 0

4. Return value

   • none

5. Simple sample code

   xxxxxxxxxx
   //turn off audio
   [[EchoP2PClient sharedP2PClient] sendCloseAudio:_did withChannel:_channelNumber];
    [[EchoP2PClient sharedP2PClient] setPlayAudioSwitch:NO];
    [[EchoP2PClient sharedP2PClient] setPlayStreamAudioSwitch:NO];
    //turn on audio
    [[EchoP2PClient sharedP2PClient] sendOpenAudio:_did withChannel:_channelNumber];
    [[EchoP2PClient sharedP2PClient] setPlayAudioSwitch:YES];
    [[EchoP2PClient sharedP2PClient] setPlayStreamAudioSwitch:YES];
   

Audio switch

xxxxxxxxxx
/**
 @brief Set the sound playback switch, generally turn on the sound first and then turn on the audio decoding
 @param bIsValue YES Turn on the sound NO Turn off the sound
 @code
 [[EchoP2PClient sharedP2PClient] setPlayAudioSwitch:NO];
 [[EchoP2PClient sharedP2PClient] setPlayStreamAudioSwitch:NO];
 @endcode
 */
-(void) setPlayAudioSwitch:(BOOL)bIsValue;

1. Function Function Explain

   • Set the sound playback switch, generally turn on the sound first and then turn on the audio decoding

   • declaration class

     xxxxxxxxxx
     DevicesManage.h
     

2. Explain the context relationship (depending on the interface or which interfaces are used with it)

   • Set the sound playback switch, generally turn on the sound first and then turn on the audio decoding

3. Parameter

   Parameter	Explain
   bIsValue	YES Turn on the sound NO Turn off the sound

4. Return value

   • none

5. Simple sample code

   xxxxxxxxxx
   //turn off audio
   [[EchoP2PClient sharedP2PClient] sendCloseAudio:_did withChannel:_channelNumber];
    [[EchoP2PClient sharedP2PClient] setPlayAudioSwitch:NO];
    [[EchoP2PClient sharedP2PClient] setPlayStreamAudioSwitch:NO];
    //turn on audio
    [[EchoP2PClient sharedP2PClient] sendOpenAudio:_did withChannel:_channelNumber];
    [[EchoP2PClient sharedP2PClient] setPlayAudioSwitch:YES];
    [[EchoP2PClient sharedP2PClient] setPlayStreamAudioSwitch:YES];
   

Audio decoding switch

xxxxxxxxxx
/**
 @brief Whether to enable audio decoding
 @param bIsValue YES Turn on the sound NO Turn off the sound
 @discusstion Usually used with -(void) setPlayAudioSwitch:(BOOL)bIsValue
 @code
 [[EchoP2PClient sharedP2PClient] setPlayAudioSwitch:NO];
 [[EchoP2PClient sharedP2PClient] setPlayStreamAudioSwitch:NO];
 @endcode
 */
-(void) setPlayStreamAudioSwitch:(BOOL)bIsValue;

1. Function Function Explain

   • Whether to enable audio decoding

   • declaration class

     xxxxxxxxxx
     DevicesManage.h
     

2. Explain the context relationship (depending on the interface or which interfaces are used with it)

   • Usually used with -(void) setPlayAudioSwitch:(BOOL)bIsValue

3. Parameter

   Parameter	Explain
   bIsValue	YES enable audio decoding NO disable audio decoding

4. Return value

   • none

5. Simple sample code

   xxxxxxxxxx
   //turn off audio
   [[EchoP2PClient sharedP2PClient] sendCloseAudio:_did withChannel:_channelNumber];
    [[EchoP2PClient sharedP2PClient] setPlayAudioSwitch:NO];
    [[EchoP2PClient sharedP2PClient] setPlayStreamAudioSwitch:NO];
    //turn on audio
    [[EchoP2PClient sharedP2PClient] sendOpenAudio:_did withChannel:_channelNumber];
    [[EchoP2PClient sharedP2PClient] setPlayAudioSwitch:YES];
    [[EchoP2PClient sharedP2PClient] setPlayStreamAudioSwitch:YES];
   

Live screenshot

Screenshot proxy implementation

xxxxxxxxxx
//acting
OpenGLViewDelegate
  
/**
 @brief single channel device
 @param image picture
 */
- (void)onScreenShotted:(UIImage*)image;
/**
 @brief multi-channel device
 @param image picture
 @param iChannel channel number
 */
- (void)onScreenShotted:(UIImage *)image withChannel:(int)iChannel;

1. Function Function Explain

   • Whether to turn on audio decoding

   • declaration class

     xxxxxxxxxx
     OpenGLView20.h
     

2. Explain the context relationship (depending on the interface or which interfaces are used with it)

   • Create an OpenGLView20 instance and set the OpenGLViewDelegate proxy

3. Parameter

   • none

4. Return value

   • none

5. Simple sample code

   xxxxxxxxxx
   //Every time you take a screenshot, set the property isScreenShotting of the OpenGLView20 instance to YES
   _gl_View.isScreenShotting = YES;
   

Live video

Turn on/off recording

xxxxxxxxxx
//Turn on/off recording
-(void)recordSwitch:(BOOL)bIsRecod recordPath:(NSString *)path withDID:(NSString *)strDID withChannel:(int)iChannel;

1. Function Function Explain

   • Whether to turn on audio decoding

   • declaration class

     xxxxxxxxxx
     DevicesManage.h
     

2. Explain the context relationship (depending on the interface or which interfaces are used with it)

   • Usually used with -(void) setPlayAudioSwitch:(BOOL)bIsValue

3. Parameter

   Parameter	Explain
   bIsRecod	YES open recording NO close recording
   path	Video file storage path
   strDID	Device did
   iChannel	Device channel number, starting from 0

4. Return value

   • none

5. Simple sample code

   xxxxxxxxxx
   //turn off recording
   [[EchoP2PClient sharedP2PClient] recordSwitch:NO recordPath:nil withDID:did withChannel:];
   

Intercom

Audio initialization

xxxxxxxxxx
[[AVAudioSession sharedInstance] setCategory:AVAudioSessionCategoryPlayAndRecord withOptions:AVAudioSessionCategoryOptionAllowBluetooth|AVAudioSessionCategoryOptionAllowBluetoothA2DP|AVAudioSessionCategoryOptionDefaultToSpeaker error:nil];

1. Function Function Explain

   • Audio initialization, set in appdelegate
   • system class

2. Explain the context relationship (depending on the interface or which interfaces are used with it)

   • To implement the intercom function, the audio must be initialized first

3. Parameter

   • none

4. Return value

   • none

5. Simple sample code

   xxxxxxxxxx
   //direct copy use
   [[AVAudioSession sharedInstance] setCategory:AVAudioSessionCategoryPlayAndRecord withOptions:AVAudioSessionCategoryOptionAllowBluetooth|AVAudioSessionCategoryOptionAllowBluetoothA2DP|AVAudioSessionCategoryOptionDefaultToSpeaker error:nil];
   

Turn on/off the audio collection function on the mobile phone

xxxxxxxxxx
//Turn on the capture and capture audio function on the mobile phone
- (void)startRecordWithDID:(NSString*)strDid;
//Turn off the audio collection function on the mobile phone
-(void) stopRecord;

1. Function Function Explain

   • Turn on/off the audio collection function on the mobile phone

   • declaration class

     xxxxxxxxxx
     EchoAudioCOntrol.h
     

2. Explain the context relationship (depending on the interface or which interfaces are used with it)

   • Turn on/off the audio collection function of the mobile phone, and use it at the same time as starting the intercom and controlling the intercom

3. Parameter

   Parameter	Explain
   strDid	Device did

4. Return value

   • none

5. Simple sample code

   xxxxxxxxxx
   //start intercom
   [[EchoAudioControl sharedThread:NO] startRecordWithDID:_did];
   [[EchoP2PClient sharedP2PClient] sendStartSpeak:_did channel:_channelNumber];
   [[EchoP2PClient sharedP2PClient] sendControlSpeak:_did ISswitch:YES];
   
   //close intercom
   [[EchoAudioControl sharedThread:NO] stopRecord];
   [[EchoP2PClient sharedP2PClient] sendControlSpeak:_did ISswitch:NO];
   [[EchoP2PClient sharedP2PClient] sendStopSpeak:_did channel:_channelNumber];
   

IntercomStart intercom

xxxxxxxxxx
//start intercom
-(void)sendStartSpeak:(NSString *)in_strDID channel:(int)channel

1. Function Function Explain

   • start intercom

   • declaration class

     xxxxxxxxxx
     DevicesManage.h
     

2. Explain the context relationship (depending on the interface or which interfaces are used with it)

   • Turn on/off the audio collection function of the mobile phone, and use it at the same time as starting the intercom and controlling the intercom

3. Parameter

   Parameter	Explain
   in_strDID	Device did
   channel	Device channel number, starting from 0

4. Return value

   • none

5. Simple sample code

   xxxxxxxxxx
   //start intercom
   [[EchoAudioControl sharedThread:NO] startRecordWithDID:_did];
   [[EchoP2PClient sharedP2PClient] sendStartSpeak:_did channel:_channelNumber];
   [[EchoP2PClient sharedP2PClient] sendControlSpeak:_did ISswitch:YES];
   
   //close intercom
   [[EchoAudioControl sharedThread:NO] stopRecord];
   [[EchoP2PClient sharedP2PClient] sendControlSpeak:_did ISswitch:NO];
   [[EchoP2PClient sharedP2PClient] sendStopSpeak:_did channel:_channelNumber];
   

IntercomControl intercom

xxxxxxxxxx
//control intercom
-(void)sendControlSpeak:(NSString *)in_strDID ISswitch:(BOOL)isSwitch;

1. Function Function Explain

   • control intercom

   • declaration class

     xxxxxxxxxx
     DevicesManage.h
     

2. Explain the context relationship (depending on the interface or which interfaces are used with it)

   • Turn on/off the audio collection function of the mobile phone, and use it at the same time as starting the intercom and controlling the intercom

3. Parameter

   Parameter	Explain
   in_strDID	Device did
   isSwitch	YES: Enabled NO: Disabled

4. Return value

   • none

5. Simple sample code

   xxxxxxxxxx
   //start intercom
   [[EchoAudioControl sharedThread:NO] startRecordWithDID:_did];
   [[EchoP2PClient sharedP2PClient] sendStartSpeak:_did channel:_channelNumber];
   [[EchoP2PClient sharedP2PClient] sendControlSpeak:_did ISswitch:YES];
   
   //close intercom
   [[EchoAudioControl sharedThread:NO] stopRecord];
   [[EchoP2PClient sharedP2PClient] sendControlSpeak:_did ISswitch:NO];
   [[EchoP2PClient sharedP2PClient] sendStopSpeak:_did channel:_channelNumber];