SoftBank Robotics documentation What's new in NAOqi 2.5?

Resources manager

The Resources manager is an efficient tool to manage resources between behaviors.

For example, if two Behaviors using the Audio player resource are executed at the same time, you will want them to obey to a certain priority rule such as “if the first behvior is using the resource, the second has to wait the end of the first behavior”.

In this tutorial will see how to manage this kind of situation over several examples.

Without resource management

Let’s create the Behavior on which we will be working all along the tutorial:

Step Action Further help
Drag and drop two Multimedia > Sound > Play sound box onto your root diagram.  
Drag and drop a Programming > Time > Wait box onto your root diagram and set the timeout parameter to 4 seconds by clicking on the Parameter parameter-button button.  
Link the input of the first Play Sound box to the beginning of the root diagram.  

Link the input of the second Play Sound box to the output of the Wait box and link the input of the Wait box to the beginning of the root diagram.

Your diagram should look like that:

../../../_images/resource_manager_tuto_base.png

Note

The Wait box is here to delay the second Play Sound box in order to start its execution when the first Play Sound box has taken the audio player resource.

 

For both Play Sound boxes, set the music file.

Warning

Choose 2 long enough and different musics, in order to be able to detect wich box is executed.

 

Start the behavior using the play-button Play button.

Without using the Resources manager, NAO plays both music together.

Let’s see how we can fix this problem, using the Resource manager.

 

Lock the resource

In this part of the tutorial we will see the effect of taking resources in both Play Sound box.

Step Action Further help

For both Play Sound boxes:

  1. Right click the box, and choose Set Resources in the contextual menu.
  2. In the resources list select the Audio > Speakers > Audio player resources.

Note

If you want to select several resources you can continuously press the Ctrl key and select other resources.

  1. Click the Ok button.
 

Start the behavior using the play-button Play button.

The first Play Sound box is executed and the second is not because the first one has locked the resource.

 

tutorial_resource_manager_lock.crg

Stop on demand

In this part will see how we can stop a box that has already locked the resource.

Step Action Further help
On the first Play Sound box, go to the Resource editor as we did before.  
Change Lock to Stop on demand.  
On the second Play Sound box, go to the Resource editor.  
Change the timeout(s) into Wait n seconds....  
Set the number of second to 1.  

Start the behavior using the play-button Play button.

The first Play Sound box is executed and stopped by the execution of the second Play Sound box after one second.

 

tutorial_resource_manager_stop_on_demand.crg

Callback on demand

With the Resource manager, when a resource is locked by a behavior, it is possible to call a method when another behavior tries to take the resource too. In this section will see how it works.

Step Action Further help
On the first Play Sound box, go to the Resource editor as we did before.  
Change Stop on demand to Callback on demand.  
Click the Ok button.  

Right click the same box and choose Edit box script in the contextual menu to open the Script editor.

You can see that the structure of the code was automatically generated.

 

Add an onResource method to the script and make NAO says something using the ALTextToSpeech module.

The code of the box should look like that:

class MyClass(GeneratedClass):
    def __init__(self):
    GeneratedClass.__init__(self)

    def onLoad(self):
        self.bIsRunning = False
        self.tts = ALProxy('ALTextToSpeech')

    def onUnload(self):
        self.bIsRunning = False

    def onInput_onStart(self):
        self.bIsRunning = True

    def onResource(self, resource):
        self.tts.say("Someone wants to take my resource " + resource)

    def onInput_onStop(self):
        if( self.bIsRunning ):
            self.onUnload()
            self.onStopped()

The method onResource will be called when another behavior will want to take the resource.

ALTextToSpeech

Start the behavior using the play-button Play button.

The first behavior is executed and when the second behavior tries to lock the resource, the first one call the onResource() method.

You can hear your robot talking.

 

tutorial_resource_manager_callback_on_demand.crg

Pause on demand

The pause on demand option can be apply only on Timeline box.

In this section, will see how to pause an animation because another behavior wants to take a resource already taken by the animation.

Step Action Further help
Drag and drop the Animation > Dialog Animations > Affirmation > NAO > GatherBothHandsInFront_01 box onto your diagram.  
Right click on it and choose Edit resources in the contextual menu.  
In the resources list select the Audio > Speakers > Audio player resource, this should deselect all the resources already selected.  
Change Lock to Pause on demand.  

Replace the first Play sound box by the Hello box.

Your diagram should look like that:

../../../_images/resource_manager_tuto_pause_on_demand.png
 

Start the behavior using the play-button Play button.

The animation is started, paused when the Play sound box is executed, and restarted when the resource is released.

 

tutorial_resource_manager_pause_on_demand.crg