AidConnect Android API

[TOC]

class AidConnect

Used for SDK initialization and log output control.

Public Member Functions

initialize()

public static AidConnect initialize(Application mApplication, boolean logDebug, AidConnectCallback aidConnectCallback)

• Parameters

Parameter Name	Type	Default	Description
mApplication	Application	-	Android Application object
logDebug	boolean	-	SDK log switch. true: prints all log levels; false: prints only error-level logs
aidConnectCallback	AidConnectCallback	-	Initialization callback

• Return

Type	Description
AidConnect	Returns the AidConnect singleton instance

addChannelWithName();

public static Set<String> addChannelWithName(String name, int size);

Creates a communication channel with the specified name and size, and returns the set of all channel names.

• Parameters

Parameter Name	Type	Default	Description
name	String	-	User-defined channel name
size	int	-	Channel size in MB

• Return

Type	Description
Set<String>	Set of all channel names

removeChannelWithName();

public static Set<String> removeChannelWithName(String name);

Removes the communication channel with the specified name and returns the set of all channel names.

• Parameters

Parameter Name	Type	Default	Description
name	String	-	Name of the channel to remove

• Return

Type	Description
Set<String>	Set of all channel names

aidConnectWithName();

public static synchronized AidConnect aidConnectWithName(String name);

Obtains the AidConnect instance for the specified channel, which is the core class for managing data interaction.

• Parameters

Parameter Name	Type	Default	Description
name	String	-	Name of the channel to use

• Return

Type	Description
AidConnect	AidConnect instance

setBytes();

public boolean setBytes(byte[] bytes);

Writes data to the channel.

• Parameters

Parameter Name	Type	Default	Description
bytes	byte[]	-	Byte array

• Return

Type	Description
boolean	Whether the write was successful

getBytes();

public byte[] getBytes(int len);

Reads data with the specified byte length.

• Parameters

Parameter Name	Type	Default	Description
len	int	-	Number of bytes to read

• Return

Type	Description
byte[]	The byte array read from the channel

getBytes();

public byte[] getBytes();

Reads all data from the last write operation (length automatically matches the write length).

• Return

Type	Description
byte[]	The byte array read from the channel

getBytes();

public byte[] getBytes(byte[] bytes, int len);

Reads data into a pre-allocated byte array with the specified length.

• Parameters

Parameter Name	Type	Default	Description
bytes	byte[]	-	Pre-allocated byte array of size len
len	int	-	Number of bytes to read

• Return

Type	Description
byte[]	The byte array read from the channel

release();

public static synchronized int release();

Releases all resources.

• Parameters

None

• Return

Type	Description
int	0: success; non-zero: failure

setStateCallback();

public static void setStateCallback(RemoteSDKStatusCallBack remoteSDKStatusCallBack);

Sets the service connection status listener callback to receive server-side state change notifications.

• Parameters

Parameter Name	Type	Default	Description
remoteSDKStatusCallBack	RemoteSDKStatusCallBack	-	Service status callback interface instance

• Note

  The SDK has already set a default callback instance during initialization. Call this method only when custom listening is needed.