SoftBank Robotics documentation What's new in NAOqi 2.8?

ALPreferenceManager

NAOqi Core - Overview | API


What it does

ALPreferenceManager allows managing the robot preferences.

Robot preferences are used to store, among other, all the settings for the applications running on the robot.

How it works

Storage

Robot preferences are stored in a database, both on the robot and on the SoftBank Robotics Cloud; ALPreferenceManager ensures the consistency between the different copies.

Format

A preference is defined by its:

  • Domain: it can be the name of the application using the preference setting.
  • Setting: it is the name of the setting.
  • Value. Only string value are currently supported.

For instance, if you are developing a chess application, you could have the following preferences:

  • Domain: “com.aldebaran.apps.chess”
  • Setting: “/game/level/default”
  • Value: “medium”

Performances and limitations

Storage

  • On the robot the preferences are stored in an SQLite database under path:

    /home/nao/.local/share/PreferenceManager/prefs.db

    Warning

    Do not to modify this file directly, it must be consistent with the copy of the preferences stored in the Cloud.

  • Domain names are limited to 512 characters.

  • Setting names are limited to 512 characters.

  • Values are limited to 1 Mega Bytes.

    For further details, see: nao Registering your NAO or pepp SBR Robot account.

Forbidden characters

To define values:

  • Use alphanumeric characters only,
  • Do not use ‘\’.

Example of use

import sys
import time
from naoqi *

NAO_IP = "nao.local"

Dummy = None
memory = None

# Create a dummy module, just to subscribe to events emitted by PreferenceManager
class DummyModule(ALModule):
    """ Dummy module """
    def __init__(self, name):
        ALModule.__init__(self, name)
        global memory
        memory = ALProxy("ALMemory")
        memory.subscribeToMicroEvent("preferenceAdded", "Dummy", "", "onPreferenceAdded")
        memory.subscribeToMicroEvent("preferenceChanged", "Dummy", "", "onPreferenceChanged")
        memory.subscribeToMicroEvent("preferenceRemoved", "Dummy", "", "onPreferenceRemoved")
        memory.subscribeToMicroEvent("preferenceDomainRemoved", "Dummy", "", "onPreferenceDomainRemoved")
    def onPreferenceAdded(self, event, value, message):
        print "Preference added: " + str(value)
    def onPreferenceChanged(self, event, value, message):
        print "Preference changed: " + str(value)
    def onPreferenceRemoved(self, event, value, message):
        print "Preference removed: " + str(value)
    def onPreferenceDomainRemoved(self, event, value, message):
        print "Preference domain removed: " + str(value)

def main():
    myBroker = ALBroker("myBroker", "0.0.0.0", 0, NAO_IP, 9559)

    global Dummy
    Dummy = DummyModule("Dummy")

    # Play with preference manager
    pm = ALProxy("ALPreferenceManager")
    pm.setValue("com.apps.chess", "level", "hard")
    pm.setValue("com.apps.chess", "treedepth", "10")
    pm.setValue("foo.bar", "foo", "bar")
    pm.setValue("com.apps.chess", "level", "easy")
    print "com.apps.chess - level: " + pm.getValue("com.apps.chess", "level")
    pm.removeValue("foo.bar", "foo")
    pm.removeDomainValues("com.apps.chess")
    print "com.apps.chess - level: " + str(pm.getValue("com.apps.chess", "level"))

    time.sleep(1)
    myBroker.shutdown()
    sys.exit(0)

if __name__ == "__main__":
    main()