Receiving actions

2min
﻿Actions are commands that the platform sends to the client. Every action has a type and we need to register an action handler for each action type. Following example shows a way to create action handler and map it to a particular action:
C++
// handler for ToggleLED action
int ToggleLED_Handler(char* args, char* actionId) {
  // Log the recieved arguments and action id to serial for the reference
  Serial.printf("*** args : %s , actionId : %s ***\n", args, actionId);

  //
  // Include command for toggling LED over here
  //

  bool status = true;

  // This function allows platform to know about the completion of particuar action 
  status = Bytebeam.publishActionCompleted(actionId);

  if(!status) {
    //
    // handle the publish action completed error here
    //

    return -1;
  }
  
  return 0;
}

//
// Once you have created an action handler for particular action then it should be
// mapped with particular action. Below function call would do that mapping.
//

// ToggleLED_Hanlder : pointer to action handler
// ToggleLED : action
Bytebeam.addActionHandler(ToggleLED_Handler, "ToggleLED");
// handler for ToggleLED action
int ToggleLED_Handler(char* args, char* actionId) {
  // Log the recieved arguments and action id to serial for the reference
  Serial.printf("*** args : %s , actionId : %s ***\n", args, actionId);

  //
  // Include command for toggling LED over here
  //

  bool status = true;

  // This function allows platform to know about the completion of particuar action 
  status = Bytebeam.publishActionCompleted(actionId);

  if(!status) {
    //
    // handle the publish action completed error here
    //

    return -1;
  }
  
  return 0;
}

//
// Once you have created an action handler for particular action then it should be
// mapped with particular action. Below function call would do that mapping.
//

// ToggleLED_Hanlder : pointer to action handler
// ToggleLED : action
Bytebeam.addActionHandler(ToggleLED_Handler, "ToggleLED");
﻿
Action status response 
While we execute the action, we need to send the progress back to the server so that the user can monitor the action remotely. To do so the following APIs can be used: 
C++

//
//  Action completed status response can be published by using below function
//
bool Bytebeam.publishActionCompleted(char* actionId);

//
//  Action failed status response can be published by using below function
//
bool Bytebeam.publishActionFailed(char* actionId, char* error = "Action Failed");

//
// Action progress status response can be published by using below function
//
bool Bytebeam.publishActionProgress(char* actionId, int progressPercentage, char* status = "Progress");


//
//  Action completed status response can be published by using below function
//
bool Bytebeam.publishActionCompleted(char* actionId);

//
//  Action failed status response can be published by using below function
//
bool Bytebeam.publishActionFailed(char* actionId, char* error = "Action Failed");

//
// Action progress status response can be published by using below function
//
bool Bytebeam.publishActionProgress(char* actionId, int progressPercentage, char* status = "Progress");
﻿
Have a look at the ToggleLED example sketch for a full-fledged example showing how to add the action and publish the action status response to bytebeam cloud.
﻿
Updated 01 Sep 2023
Did this page help you?
Pushing data to Bytebeam
Integrate Over the Air Updates