原文地址：http://blog.starrtc.com/?p=94
1 创建工程
IDE：Android Studio 3.1；
File>New>New Project>输入项目名>next>Target Android Devices 复选框勾选 Phone and Tablet 和 Android Things>next… finish；
创建成功后项目会包括mobile和things两个module，mobile是手机端程序，things是小车上的程序。
things部分编译出来的是apk只能运行在Android Things系统上，后面我们会在树莓派上运行这module。
2 导入StarRTC SDK
SDK下载：https://docs.starrtc.com/download/
开发文档：https://docs.starrtc.com/docs/android-1.html
按照开发文档所述，分别在mobile和things两个module下导入StarRTC的sdk。
3 开始码代码，小车端程序（things module）
这个项目的代码大部分都是从StarRTC官网demo源码中拷贝过来的，并做了些简单的修改。
3.1 小车开机后原地待命
小车要先登录StarRTC的服务，后边才能接收到手机端的启动指令。
//设置小车的ID，后边要通过这个ID来唤醒小车 MLOC.userId = "car0001"; //设置适合树莓派的默认参数值 XHClient.getInstance().setDefaultConfig(true,true,0,0,1,false,false,false,false,XHConstants.XHCropTypeEnum.STAR_VIDEO_CROP_CONFIG_BIG_NOCROP_SMALL_NONE); XHClient.getInstance().setCustomEncoderConfig(640,480,640,480,15,500,45); //初始化SDK，添加登录和消息状态监听 XHClient.getInstance().initSDK(this, new XHSDKConfig(MLOC.agentId),MLOC.userId); XHClient.getInstance().getChatManager().addListener(new XHChatManagerListener()); XHClient.getInstance().getLoginManager().addListener(new XHLoginManagerListener()); checkNetAvailable();
这里有个问题要注意一下，本来这段初始化代码最后，就要进行登录操作了，但树莓派开机时，会第一时间自动运行小车的程序，这样就可能遇到程序在进行初始化时，网络未连接或设备时间未同步的问题。这两个问题都会导致登录失败。所以登录之前先检查一下网络是否已经可用，时间是否已经同步。这里只是判断了时间中的year部分是否包含”201″。
private Timer checkNetTimer = new Timer();
private void checkNetAvailable(){
checkNetTimer.schedule(new TimerTask() {
@Override
public void run() {
Runtime runtime = Runtime.getRuntime();
Process pingProcess = null;
try {
String nowDate = new SimpleDateFormat("yyyy-MM-dd HH:mm").format(new java.util.Date());
//时间是否已经同步
if(nowDate.contains("201")){
checkNetTimer.cancel();
InterfaceUrls.demoLogin(MLOC.userId);
}
} catch (Exception e) {
e.printStackTrace();
}
}
},3000,3000);
}
上边代码中InterfaceUrls.demoLogin(MLOC.userId)是向服务器获取登录证明AuthKey的，拿到证明之后就是真正的登录了。这里我通过自定义的事件来专递各种消息和参数。
登录SDK成功后，小车将处于待命状态，等待操控者的启动指令。这里使用的启动指令是“IotCarStart”这个字符串。
@Override
public void dispatchEvent(String aEventID, boolean success, Object eventObj) {
switch (aEventID){
case AEvent.AEVENT_LOGIN:
if(success){
MLOC.d("", (String) eventObj);
//登录SDK
XHClient.getInstance().getLoginManager().login(MLOC.authKey, new IXHCallback() {
@Override
public void success(Object data) {
isLogin = true;
}
@Override
public void failed(final String errMsg) {
MLOC.d("",errMsg);
runOnUiThread(new Runnable() {
@Override
public void run() {
MLOC.showMsg(SplashActivity.this,errMsg);
}
});
}
});
}else{
MLOC.d("", (String) eventObj);
}
break;
case AEvent.AEVENT_C2C_REV_MSG:
XHIMMessage message = (XHIMMessage) eventObj;
String command = message.contentData;
switch (command){
case "IotCarStart":
startCar(message.fromId);
break;
}
break;
}
}
private void startCar(String fromId){
removeListener();
Intent intent = new Intent(SplashActivity.this,SampleLiveActivity.class);
intent.putExtra("driverId",fromId);
startActivity(intent);
}
3.2 小车收到开机指令
当手机端通过IM，向小车发送一条内容为“IotCarStart”的一对一消息时，小车就会启动，并且记录操控者的ID，直到本次遥控结束，小车将忽略其他人发来的一切消息。
小车启动时，要创建一个互动直播的房间，并开始直播。开始直播后，通过一对一消息将直播间的id发给手机端。手机端通过直播间id进入直播间，并申请连麦。小车收到连麦申请后判断是否是操控者发来的，是操控者将允许连麦，否则拒绝连麦。
private void createLive(){
//创建直播
final XHLiveItem liveItem = new XHLiveItem();
liveItem.setLiveType(XHConstants.XHLiveType.XHLiveTypeGlobalPublic);
liveItem.setLiveName(MLOC.userId);
//创建直播间
liveManager.createLive(liveItem, new IXHCallback() {
@Override
public void success(Object data) {
//创建成功
MLOC.d("XHLiveManager","createLive success "+data);
liveId = (String) data;
MLOC.saveSharedData(SampleLiveActivity.this,MLOC.userId+"_iotCarId", liveId);
InterfaceUrls.demoReportLive(liveId,liveItem.getLiveName(),MLOC.userId);
starLive();
}
@Override
public void failed(final String errMsg) {
//创建失败
MLOC.d("XHLiveManager","createLive failed "+errMsg);
removeListener();
finish();
}
});
}
private void starLive(){
//开始直播
liveManager.startLive(liveId, new IXHCallback() {
@Override
public void success(Object data) {
//成功
MLOC.d("XHLiveManager","startLive success "+data);
//给操控者发送直播间ID
XHClient.getInstance().getChatManager().sendOnlineMessage(liveId, driverId, null);
}
@Override
public void failed(final String errMsg) {
//失败
MLOC.d("XHLiveManager","startLive failed "+errMsg);
MLOC.saveSharedData(SampleLiveActivity.this,MLOC.userId+"_iotCarId", "");
stop();
}
});
}
@Override
public void dispatchEvent(String aEventID, boolean success, final Object eventObj) {
MLOC.d("XHLiveManager","dispatchEvent "+aEventID + eventObj);
switch (aEventID){
case AEvent.AEVENT_C2C_REV_MSG:
XHIMMessage message = (XHIMMessage) eventObj;
if(message.fromId.equals(driverId)){
String command = message.contentData;
if(command.equals("IotCarStart")){
XHClient.getInstance().getChatManager().sendOnlineMessage(liveId, driverId, null);
}
}
break;
case AEvent.AEVENT_LIVE_ADD_UPLOADER:
//连麦者加入，因为小车不需要播放，所以设置为不接收视频
StarRtcCore.getInstance().setNullVideo();
break;
case AEvent.AEVENT_LIVE_REMOVE_UPLOADER:
//操控者退出，本次操控结束
driverId = "";
stop();
break;
case AEvent.AEVENT_LIVE_APPLY_LINK:
//收到连麦申请
if(driverId.equals((String) eventObj)){
// 操控者申请，自动同意上麦
liveManager.agreeApplyToBroadcaster(driverId);
}else{
// 拒绝其他人上麦
liveManager.refuseApplyToBroadcaster((String) eventObj);
}
break;
case AEvent.AEVENT_LIVE_ERROR:
removeListener();
finish();
MLOC.d("VideoLiveActivity","AEVENT_LIVE_ERROR "+eventObj);
break;
case AEvent.AEVENT_LIVE_REV_REALTIME_DATA:
// 收到实时流数据，操控车的指令
if(success){
try {
JSONObject jsonObject = (JSONObject) eventObj;
final byte[] tData = (byte[]) jsonObject.get("data");
runOnUiThread(new Runnable() {
@Override
public void run() {
//给小车下达指令
GpioManager.getInstance().controlCar(tData);
}
});
} catch (JSONException e) {
e.printStackTrace();
}
}
break;
}
}
4 通过树莓派GPIO和PWM控制小车运动
4.1 GPIO控制驱动电机
我购买的直流电机驱动板可以直接插在树莓派上，并将树莓的引脚再次暴露出来，用起来比较方便。
根据驱动板使用说明，将电机线接到驱动板上，然后通过GPIO设置相应引脚的高低电平就能控制电机的启动停止和正转反转。
使用GPIO要记得先申请相关权限
GPIO使用前记得重置，使用后记得销毁，GPIO口一旦被占用，后来者将无法使用。
//初始化小车需要的GPIO口
public void initCarGpio(){
manager = PeripheralManager.getInstance();
try {
mGpioLeftRun = manager.openGpio(GpioNameLeftRun);
resetGpio(mGpioLeftRun);
mGpioLeftDirection = manager.openGpio(GpioNameLeftDirection);
resetGpio(mGpioLeftDirection);
mGpioRightRun = manager.openGpio(GpioNameRightRun);
resetGpio(mGpioRightRun);
mGpioRightDirection = manager.openGpio(GpioNameRightDirection);
resetGpio(mGpioRightDirection);
} catch (IOException e) {
MLOC.d("IOTCAR","initCarGpio IOException"+e.getMessage());
e.printStackTrace();
}
MLOC.d("IOTCAR","initCarGpio");
}
//关闭车
public void stopCarGpio(){
destoryGpio(mGpioLeftRun);
destoryGpio(mGpioLeftDirection);
destoryGpio(mGpioRightRun);
destoryGpio(mGpioRightDirection);
MLOC.d("IOTCAR","stopCarGpio");
}
//重置GPIO
private void resetGpio(Gpio gpio){
try {
if(gpio!=null) {
gpio.setDirection(Gpio.DIRECTION_OUT_INITIALLY_LOW);//设置为输出，默认低电平
gpio.setActiveType(Gpio.ACTIVE_HIGH);//设置高电平为活跃的
gpio.setValue(false);//设置成低电平
}
} catch (IOException e) {
e.printStackTrace();
}
}
//销毁GPIO
private void destoryGpio(Gpio gpio){
try {
if(gpio!=null){
gpio.close();
gpio = null;
}
} catch (IOException e) {
e.printStackTrace();
}
}
在这吐糟一下树莓派和电机驱动板，树莓派每次通电开机时，控制电机使能的两个GPIO口默认输出的都是高电平，导致小车每次开机时会不受控制的一直往前跑。直到开始运行程序，GPIO口被重置成低电平才会停下来…
4.2 PWM控制云台舵机旋转
摄像头云台的控制需要使用PWM，Android Things在树莓派上提供了两个可以生成PWM波的引脚，正好可以将云台的两个舵机接入到树莓派的相应PWM引脚上，一个控制左右转动，一个控制上上下转动。
这里需要说一下自己碰到的坑，刚开始不知道Android Things提供了PWM的API，所以自己写了一个SoftPWM。但是PWM的周期是20ms,控制舵机从0到180度转动所需的高电平宽度是0.5ms-1.5ms,然而java的计时器最小单位就是ms,所以根本无法满足舵机调节角度的精度需求。幸亏很快发现了系统提供的API。之后又遇到个坑，只要小车打开视频，云台就无法控制。后来定位到问题是，播放声音时speaker也是通过PWM控制发声的，也就是说PWM被系统拿去播放音频了，所以云台无法控制。解决这个问题只需要再加一个PWM发生器即可，我选择了另一条路，禁用了小车的音频输出。
继续说舵机和PWM，PWM是通过设置频率和占空比来产生不通方波的，理论上舵机的0~180度对应的高电平宽是0.5ms~1.5ms,也就是0度的占空比 = 0.5ms/20ms = 2.5%,可能因为理论值和实际值有偏差，经过我的测试，设置占空比为3.27%时，也就是高电平宽w = 3.27%*20ms = 0.654ms时，舵机的角度为0度。后边又测出了180度时的占空比值，最终计算出角度每增加1度，占空比增加约0.0463。有了0度的基础值和单步值，后边设置角度时就比较方便了。
比如 90度时PWM的占空比=3.27+90*0.0463。
PWM最好持续输出，时断时续的容易造成舵机无规则摆动，停止遥控时一定要记得停止你使用的PWM，不然舵机一直工作，影响舵机使用寿命和电池续航。
public void initCarPwm(){
MLOC.d("IOTCAR_PWM","initCarPwm");
manager = PeripheralManager.getInstance();
try {
if(mPwmCameraH!=null) {
mPwmCameraH.setEnabled(false);
mPwmCameraH.close();
mPwmCameraH = null;
}
running.set(true);
mPwmCameraH = manager.openPwm(GpioNameHRotate);
mPwmCameraH.setPwmDutyCycle(beginValue+90*stepLenght);//设置占空比
mPwmCameraH.setPwmFrequencyHz(50);//设置频率
mPwmCameraH.setEnabled(true); //开始生成PWM
if(mPwmCameraV!=null) {
mPwmCameraV.setEnabled(false);
mPwmCameraV.close();
mPwmCameraV = null;
}
mPwmCameraV = manager.openPwm(GpioNameVRotate);
mPwmCameraV.setPwmDutyCycle(beginValue+40*stepLenght);
mPwmCameraV.setPwmFrequencyHz(50);
mPwmCameraV.setEnabled(true);
} catch (IOException e) {
e.printStackTrace();
}
}
public void changePwm(){
try {
if(mPwmCameraV!=null&&lastCameraV!=camearV.get()){
mPwmCameraV.setEnabled(false);//先停掉之前的PWM
mPwmCameraV.setPwmDutyCycle(beginValue+camearV.get()*stepLenght);//重新设置占空比
mPwmCameraV.setEnabled(true);//开始生成PWM
lastCameraV = camearV.get();
}
if(mPwmCameraH!=null&&lastCameraH!=camearH.get()){
mPwmCameraH.setEnabled(false);
mPwmCameraH.setPwmDutyCycle(beginValue+camearH.get()*stepLenght);
mPwmCameraH.setEnabled(true);
lastCameraH = camearH.get();
}
} catch (IOException e) {
e.printStackTrace();
}
}
public void stopPwm(){
running.set(false);
if(mPwmCameraH!=null){
try {
mPwmCameraH.setEnabled(false);
mPwmCameraH.close();
mPwmCameraH = null;
} catch (IOException e) {
e.printStackTrace();
}
}
if(mPwmCameraV!=null){
try {
mPwmCameraV.setEnabled(false);
mPwmCameraV.close();
mPwmCameraV = null;
} catch (IOException e) {
e.printStackTrace();
}
}
MLOC.d("IOTCAR_PWM","stopPwm");
}
到这里小车端的程序介绍完了，后边再说说手机端。
同行的认可是远行最大的动力，欢迎转载本博客文章，转载请注明出处，十分感谢。
StarRTC , AndroidThings , 树莓派小车，公网环境，视频遥控(一)准备工作
StarRTC , AndroidThings , 树莓派小车，公网环境，视频遥控(二)小车端
StarRTC , AndroidThings , 树莓派小车，公网环境，视频遥控(三)手机端
源码下载地址