Rux RobotSDK

一、 Download Resources

RobotSdk-release.2.0.aar

RobotSdk-release.1.0.aar

二、Introduction to RobotSDK

RobotSDK 2.0 release notes:
1. Added expression display interface

RobotSDK 1.0 release notes:
1. Control the robot’s movements.
2. Control the robot antenna rotation and lighting effects.
3. Use customized sound effects inside the robot.
4. The customized text is read out by the robot in voice.
5. Get the robot’s obstacle avoidance and cliff-triggered events to customize the robot’s behavior.

三、RobotSDK development documentation

• Copy the SDK to the libs directory

• Add the following content to the build.gradle file dependencies in the project directory

 dependencies {
      implementation(fileTree("libs"))
  }

• Get an instance of RobotService

// Before executing an action, the servo power needs to be turned on. Do not execute it in the main thread. Only needs to be executed once.
mRobotService.robotOpenMotor();

// Turn off the servo power.
mRobotService.robotCloseMotor();

private ActionMessage mMessage = new ActionMessage();
mMessage.set(
    63, // number: Robot action number, refer to the robot action number.
    2, // speed: Robot execution speed.
    3); // stepNum: Robot step count.

// Start executing the action.
mRobotService.robotActionCommand(mMessage);

// Unbind the RobotService.
mRobotService.unbindService();

• Robot Sensor event response

// Define a SensorCallback
SensorCallback callback = new SensorCallback() {
@Override
public void onTapResponse() {
    // Callback interface triggered by a single tap on the head.
}

    @Override
    public void onDoubleTapResponse() {
        // Callback interface triggered by two consecutive taps on the head
    }

    @Override
    public void onLongPressResponse() {
        // Callback interface triggered by a long press on the head.
    }

    @Override
    public void onFallBackend() {
        // Triggered when a cliff is detected in front.
    }

    @Override
    public void onFallForward() {
        // Triggered when a cliff is detected behind.
    }

    @Override
    public void onFallRight() {
         // Triggered when a cliff is detected on the left side.
    }

    @Override
    public void onFallLeft() {
         // Triggered when a cliff is detected on the right side.
    }

    @Override
    public void onTof() {
        // Triggered when an obstacle is detected.
    }
};
// Turn on the sensor power
mRobotService.robotOpenSensor();
// Turn off the sensor power
mRobotService.robotCloseSensor();
// Register the callback to the sensor service
mRobotService.robotRegisterSensorCallback(callback);

• Robot antenna rotation control

AntennaMessage antennaMessage = new AntennaMessage();
antennaMessage.set(
    3,        // cmd：1 for both ears turn left, 2 for both ears turn right, 3 for both ears turn left
    2,        // step: indicates the number of times the action is executed
    300,      // speed: indicates the time interval for the continuous action in milliseconds
    60);      // angle: indicates the amplitude of the action in degrees (0°~90°, >90° default to 90°)
    
 mRobotService.robotAntennaMotion(antennaMessage);

• Robot antenna light color control

AntennaLightMessage alMessage = new AntennaLightMessage();
// Set the antenna light color
alMessage.set(Light.RED); 
// Turn on the antenna light and set the color
mRobotService.robotAntennaLight(alMessage);
// Turn off the light
mRobotService.robotCloseAntennaLight（）

• Robot sound control

// The robot can play pre-existing sound effects
mRobotService.robotControlSound("a0003");  //Refer to the robot sound effect number

• Robot text to sound effect

// Convert text to speech and play it
mRobotService.robotPlayTTs("Hello");

• Control robot status bar display（Deprecated）

mRobotService.robotControlStatusBar(StatusBarCmd.COMMAND_SHOW_CHARGING);

COMMAND_SHOW_CHARGING    Show the charging icon on the status bar.
COMMAND_HIDE_CHARGING    Hide the charging icon on the status bar.

• Robot expression control

// Enter expression mode, only needs to be executed once. The parameter represents the expression to be displayed in the mode.
mRobotService.robotStartExpression("h0003"); 
// Switch expressions within the expression mode.
mRobotService.sendExpressionCommand("h003");
// Exit the expression mode.
mRobotService.robotStopExpression();

• Robot action

1 - walking forward (default parameters: step=n, speed=3).
2 - walking backward (default parameters: step=n, speed=3).
3 - turning left (default parameters: step=n, speed=3).
4 - turning right (default parameters: step=n, speed=3).
5 - crab walk to the left (default parameters: step=n, speed=3).
6 - crab walk to the right (default parameters: step=n, speed=3).
7 - shaking the left leg (default parameters: step=1, delay=2).
8 - shaking the right leg (default parameters: step=1, delay=2).
9 - shaking the left foot (default parameters: step=2, delay=3).
10 - shaking the right foot (default parameters: step=2, delay=3).
11 - lifting the left foot (default parameters: step=1, delay=1).
12 - lifting the right foot (default parameters: step=1, delay=1).
13 - leaning left (default parameters: step=1, delay=6).
14 - leaning right (default parameters: step=1, delay=6).
15 - stomping the left foot (default parameters: step=1, delay=3).
16 - stomping the right foot (default parameters: step=1, delay=3).
17 - swinging the body up and down (default parameters: step=1, delay=1).
18 - swinging the body left and right (default parameters: step=1, delay=1).
19 - shaking the head left and right (default parameters: step=2, delay=1).
20 - standing at ease (default parameters: step=1, delay=1).
21 - spinning in place to the left (default parameters: step=1 (≈20°), delay=3).
22 - spinning in place to the right (default parameters: step=1 (≈20°), delay=3).
23 - double foot shaking (default parameters: step=3, delay=1).
24 - slight shaking (default parameters: step=1, delay=3).
25 - slight left turn (default parameters: step=1 (≈5°), delay=3).
26 - slight right turn (default parameters: step=1 (≈5°), delay=3).
27 - swaying (default parameters: step=1, speed=3).
28 - head shaking (default parameters: step=1, speed=3).
29 - random action 29 (default parameters: step=1, speed=3).
30 - random action 30 (default parameters: step=1, speed=3).
31 - random action 31 (default parameters: step=1, speed=3).
32 - random action 32 (default parameters: step=1, speed=3).
33 - random action 33 (default parameters: minimum count=3, speed=3).
34 - slight foot rotation (default parameters: minimum count=3, speed=3).
35 - random action 35 (default parameters: step=1, speed=3).
36 - random action 36 (default parameters: step=1, speed=3).
37 - random action 37 (default parameters: step=1, speed=3).
38 - slight left foot shaking (default parameters: step=1, speed=3).
39 - slight right foot shaking (default parameters: step=1, speed=3).
40 - random action 40 (default parameters: step=1, speed=3).
41 - random action 41 (default parameters: step=1, speed=3).
42 - random action 42 (default parameters: step=1, speed=3).
43 - slight head shaking (default parameters: step=1, speed=3).
44 - left dodge (default parameters: step=1, speed=3).
45 - right dodge (default parameters: step=1, speed=3).
46 - slight left dodge (default parameters: step=1, speed=3).
47 - slight right dodge (default parameters: step=1, speed=3).
48 - rapid shaking of both feet (default parameters: step=1, fixed speed).
49 - rapid foot shaking (default parameters: step=1, fixed speed).
50 - twisting back and forth (default parameters: step=1, speed=3).
51 - slight left foot shaking (default parameters: step=1, speed=3).
52 - slight right foot shaking (default parameters: step=1, speed=3).
53 - left foot outward turn (default parameters: step=1, speed=3).
54 - right foot outward turn (default parameters: step=1, speed=3).
55 - left turn -3 degrees (default parameters: step=1, speed=3).
56 - right turn -3 degrees (default parameters: step=1, speed=3).
57: slight turn of the right foot (Default parameters: step = 1, speed = 3)
58: large evasion to the right (Default parameters: step = 1, fixed speed)
59: foot rubbing - rubbing in front, middle, and back (Default parameters: step = 1, speed = 3)
60: foot rubbing - rubbing in front and back (Default parameters: step = 1, speed = 3)
61: suspended action - lifting the leg (Default parameters: step = 1, fixed speed)
62: lifting the leg and shaking the foot (Default parameters: step = 1, fixed speed)
63: forward movement 2 (Default parameters: step = 1, speed = 3)
64: backward movement 2 (Default parameters: step = 1, speed = 3)
65: quick left foot rotation (Default parameters: minimum count = 3, fixed speed)
66: quick right foot rotation (Default parameters: minimum count = 3, fixed speed)
67: quick foot shaking (Default parameters: step = 1, fixed speed)
68: quick foot shaking outward (Default parameters: step = 1, fixed speed)
69: second method of standing on a stake (Default parameters: step = 1, speed = 1)
70: third method of standing on a stake (Default parameters: step = 1, speed = 1)
71: first rotation on the stake (Default parameters: step = 1, speed = 2)
72: second rotation on the stake (Default parameters: step = 1, speed = 2)
73: third rotation on the stake (Default parameters: step = 1, speed = 2)
74: fourth rotation on the stake (Default parameters: step = 1, speed = 2)
75: fifth rotation on the stake (Default parameters: step = 1, speed = 2)
76: nodding (Default parameters: step = 1, speed = 3)
77: saying "yeah" (Default parameters: step = 1, speed = 3)
78: quick twisting (Default parameters: step = 1, speed = 1)
79: body shaking (Default parameters: step = 1, speed = 1)
80: dancing twisting (Default parameters: step = 2, speed = 6)

• Robot sound effect

{
"cmd_tag":"a0001",
"cmd_tag_name":"Beep"
},
{
"cmd_tag":"a0005",
"cmd_tag_name":"Hammering sound"
},
{
"cmd_tag":"a0007",
"cmd_tag_name":"Laser"
},
{
"cmd_tag":"a0010",
"cmd_tag_name":"Pulse"
},
{
"cmd_tag":"a0011",
"cmd_tag_name":"Electromagnetic"
},
{
"cmd_tag":"a0012",
"cmd_tag_name":"Electromagnetic 2"
},
{
"cmd_tag":"a0014",
"cmd_tag_name":"Submachine gun"
},
{
"cmd_tag":"a0019",
"cmd_tag_name":"Gudong"
},
{
"cmd_tag":"a0020",
"cmd_tag_name":"Angry"
},
{
"cmd_tag":"a0021",
"cmd_tag_name":"Buzz"
},
{
"cmd_tag":"a0024",
"cmd_tag_name":"Obstacle avoidance"
},
{
"cmd_tag":"a0025",
"cmd_tag_name":"Charging"
},
{
"cmd_tag":"a0026",
"cmd_tag_name":"Charging 2"
},
{
"cmd_tag":"a0027",
"cmd_tag_name":"Charging 3"
},
{
"cmd_tag":"a0028",
"cmd_tag_name":"Click"
},
{
"cmd_tag":"a0029",
"cmd_tag_name":"Alarm"
},
{
"cmd_tag":"a0030",
"cmd_tag_name":"Comfortable"
},
{
"cmd_tag":"a0031",
"cmd_tag_name":"Confused"
},
{
"cmd_tag":"a0032",
"cmd_tag_name":"Hahaha"
},
{
"cmd_tag":"a0033",
"cmd_tag_name":"Disgusted"
},
{
"cmd_tag":"a0034",
"cmd_tag_name":"Dizziness"
},
{
"cmd_tag":"a0035",
"cmd_tag_name":"Dizziness 2"
},
{
"cmd_tag":"a0036",
"cmd_tag_name":"Fatigue"
},
{
"cmd_tag":"a0037",
"cmd_tag_name":"Fear"
},
{
"cmd_tag":"a0038",
"cmd_tag_name":"Search"
},
{
"cmd_tag":"a0039",
"cmd_tag_name":"Surprised"
},
{
"cmd_tag":"a0040",
"cmd_tag_name":"Complete"
},
{
"cmd_tag":"a0041",
"cmd_tag_name":"Duplicate of 29"
},
{
"cmd_tag":"a0053",
"cmd_tag_name":"Annoying"
},
{
"cmd_tag":"a0054",
"cmd_tag_name":"I'm an optimist"
},
{
"cmd_tag":"a0055",
"cmd_tag_name":"Low battery"
},
{
"cmd_tag":"a0056",
"cmd_tag_name":"Alarm"
},
{
"cmd_tag":"a0057",
"cmd_tag_name":"Out of power"
},
{
"cmd_tag":"a0058",
"cmd_tag_name":"Main jump"
},
{
"cmd_tag":"a0059",
"cmd_tag_name":"Error"
},
{
"cmd_tag":"a0064",
"cmd_tag_name":"Panting"
},
{
"cmd_tag":"a0067",
"cmd_tag_name":"Ah-woo"
},
{
"cmd_tag":"a0069",
"cmd_tag_name":"Dengdengdeng~"
},
{
"cmd_tag":"a0070",
"cmd_tag_name":"Panicked"
},
{
"cmd_tag":"a0071",
"cmd_tag_name":"Duplicate of 51"
},
{
"cmd_tag":"a0074",
"cmd_tag_name":"Duplicate of 31"
},
{
"cmd_tag":"a0077",
"cmd_tag_name":"Snoring"
},
{
"cmd_tag":"a0078",
"cmd_tag_name":"Duplicate of 36"
},
{
"cmd_tag":"a0082",
"cmd_tag_name":"Duplicate of 70"
},
{
"cmd_tag":"a0083",
"cmd_tag_name":"Duplicate of 64"
},
    {
"cmd_tag": "a0084",
"cmd_tag_name": "Response"
},
{
"cmd_tag": "a0086",
"cmd_tag_name": "Sad"
},
{
"cmd_tag": "a0088",
"cmd_tag_name": "Power off"
},
{
"cmd_tag": "a0089",
"cmd_tag_name": "Chirp~~"
},
{
"cmd_tag": "a0090",
"cmd_tag_name": "Shy"
},
{
"cmd_tag": "a0091",
"cmd_tag_name": "Repeat with 77"
},
{
"cmd_tag": "a0092",
"cmd_tag_name": "Peek"
},
{
"cmd_tag": "a0093",
"cmd_tag_name": "Power on"
},
{
"cmd_tag": "a0094",
"cmd_tag_name": "Search person 2"
},
{
"cmd_tag": "a0095",
"cmd_tag_name": "Surprised"
},
{
"cmd_tag": "a0097",
"cmd_tag_name": "Same as 95"
},
{
"cmd_tag": "a0098",
"cmd_tag_name": "Tired"
},
{
"cmd_tag": "a0099",
"cmd_tag_name": "Wake up"
},
{
"cmd_tag": "a0100",
"cmd_tag_name": "Happy birthday"
},
{
"cmd_tag": "a0104",
"cmd_tag_name": "Ding ding ding~"
},
{
"cmd_tag": "a0106",
"cmd_tag_name": "Play Ula"
},
{
"cmd_tag": "a0107",
"cmd_tag_name": "Awkward"
},
{
"cmd_tag": "a0108",
"cmd_tag_name": "Ding Ling Ling"
},
{
"cmd_tag": "a0112",
"cmd_tag_name": "Huh?"
},
{
"cmd_tag": "a0113",
"cmd_tag_name": "Bite and crush"
},
{
"cmd_tag": "a0114",
"cmd_tag_name": "Drumming"
},
{
"cmd_tag": "a0115",
"cmd_tag_name": "Proud"
},
{
"cmd_tag": "a0117",
"cmd_tag_name": "Same as 107"
},
{
"cmd_tag": "a0118",
"cmd_tag_name": "Honk the horn"
},
{
"cmd_tag": "a0120",
"cmd_tag_name": "Cicada chirping"
},
{
"cmd_tag": "a0121",
"cmd_tag_name": "Doorbell"
},
{
"cmd_tag": "a0124",
"cmd_tag_name": "Gurgling"
},
{
"cmd_tag": "a0125",
"cmd_tag_name": "Typing"
},
{
"cmd_tag": "a0126",
"cmd_tag_name": "New message"
},
{
"cmd_tag": "a0127",
"cmd_tag_name": "New message 2"
},
{
"cmd_tag": "a0128",
"cmd_tag_name": "New message 3"
},
{
"cmd_tag": "a0132",
"cmd_tag_name": "Phone sound 2"
},
{
"cmd_tag": "a0133",
"cmd_tag_name": "Lost"
}

• Robot expression animation list

[{
	"cmd_tag": "h0003",
	"cmd_tag_name": "ashamed",
}
{
	"cmd_tag": "h0006",
	"cmd_tag_name": "Happy"
},
{
	"cmd_tag": "h0027",
	"cmd_tag_name": "Love"
},
{
	"cmd_tag": "h0017",
	"cmd_tag_name": "Frown"
},
{
	"cmd_tag": "h0011",
	"cmd_tag_name": "Dizziness"
},
{
	"cmd_tag": "h0034",
	"cmd_tag_name": "Shake your head"
},
{
	"cmd_tag": "h0024",
	"cmd_tag_name": "Look right"
},
{
	"cmd_tag": "h0025",
	"cmd_tag_name": "Look left"
},
{
	"cmd_tag": "h0001",
	"cmd_tag_name": "Angry"
},
{
	"cmd_tag": "h0005",
	"cmd_tag_name": "Barbie Q"
},
{
	"cmd_tag": "h0015",
	"cmd_tag_name": "Look around"
},
{
	"cmd_tag": "h0018",
	"cmd_tag_name": "Angry2"
},
{
	"cmd_tag": "h0026",
	"cmd_tag_name": "Look down"
},
{
	"cmd_tag": "h0028",
	"cmd_tag_name": "Pain"
},
{
	"cmd_tag": "h0033",
	"cmd_tag_name": "Resist"
},
{
	"cmd_tag": "h0035",
	"cmd_tag_name": "Shut up"
},
{
	"cmd_tag": "h0040",
	"cmd_tag_name": "Sorry"
},
{
	"cmd_tag": "h0046",
	"cmd_tag_name": "surprised"
},
{
	"cmd_tag": "h0050",
	"cmd_tag_name": "Hehe"
},
{
	"cmd_tag": "h0051",
	"cmd_tag_name": "Cold"
},
{
	"cmd_tag": "h0052",
	"cmd_tag_name": "Uncomfortable"
},
{
	"cmd_tag": "h0055",
	"cmd_tag_name": "Yawn"
},
{
	"cmd_tag": "h0099",
	"cmd_tag_name": "Too hot"
},
{
	"cmd_tag": "h0118",
	"cmd_tag_name": "Shy"
},
{
	"cmd_tag": "h0119",
	"cmd_tag_name": "Tearful"
},
{
	"cmd_tag": "h0133",
	"cmd_tag_name": "Afraid"
},
{
	"cmd_tag": "h0134",
	"cmd_tag_name": "Disco"
},
{
	"cmd_tag": "h0178",
	"cmd_tag_name": "Look aside"
},
{
	"cmd_tag": "h0182",
	"cmd_tag_name": "Photograph"
},
{
	"cmd_tag": "h0189",
	"cmd_tag_name": "Comfortable"
},
{
	"cmd_tag": "h0208",
	"cmd_tag_name": "Arrogance"
},
{
	"cmd_tag": "h0210",
	"cmd_tag_name": "Laugh"
},
{
	"cmd_tag": "h0211",
	"cmd_tag_name": "Cry"
}]