# SoftBank Robotics documentation What's new in NAOqi 2.8?

# ALAnimationPlayer Tutorials

NAOqi Motion - Overview | API | Tutorials | Advanced

## Python

### Start, stop or wait an animation

`alanimationplayer_tutorial_run.py`

    #! /usr/bin/env python
    # -*- encoding: UTF-8 -*-

    """Example: Use run Method"""

    import qi
    import argparse
    import sys

    def main(session):
        """
        This example uses the run method.
        """
        # Get the service ALAnimationPlayer.

        animation_player_service = session.service("ALAnimationPlayer")

        # play an animation, this will return when the animation is finished
        animation_player_service.run("animations/Stand/Gestures/Hey_1")

        # play an animation, this will return right away
        future = animation_player_service.run("animations/Stand/Gestures/Hey_1", _async=True)
        # wait the end of the animation
        future.value()

        # play an animation, this will return right away
        future = animation_player_service.run("animations/Stand/Gestures/Hey_1", _async=True)
        # stop the animation
        future.cancel()

    if __name__ == "__main__":
        parser = argparse.ArgumentParser()
        parser.add_argument("--ip", type=str, default="127.0.0.1",
                            help="Robot IP address. On robot or Local Naoqi: use '127.0.0.1'.")
        parser.add_argument("--port", type=int, default=9559,
                            help="Naoqi port number")

        args = parser.parse_args()
        session = qi.Session()
        try:
            session.connect("tcp://" + args.ip + ":" + str(args.port))
        except RuntimeError:
            print ("Can't connect to Naoqi at ip \"" + args.ip + "\" on port " + str(args.port) +".\n"
                   "Please check your script arguments. Run with -h option for help.")
            sys.exit(1)
        main(session)

To execute this script, type:

    python alanimationplayer_tutorial_run.py --qi-url=tcp://<robot name or robot id>:9559

### Run an animation according to the context

`alanimationplayer_tutorial_runcontextual.py`

    #! /usr/bin/env python
    # -*- encoding: UTF-8 -*-

    """Example: Use run and runTag Methods"""

    import qi
    import argparse
    import sys

    def main(session):
        """
        This example uses the run and runTag methods.
        """
        # Get the service ALAnimationPlayer.

        animation_player_service = session.service("ALAnimationPlayer")

        # [posture] will be replaced by Stand, Sit or SitOnPod
        animation_player_service.run("animations/[posture]/Gestures/Hey_3")
        # run animation that have the tag "hello"
        animation_player_service.runTag("hello")

    if __name__ == "__main__":
        parser = argparse.ArgumentParser()
        parser.add_argument("--ip", type=str, default="127.0.0.1",
                            help="Robot IP address. On robot or Local Naoqi: use '127.0.0.1'.")
        parser.add_argument("--port", type=int, default=9559,
                            help="Naoqi port number")

        args = parser.parse_args()
        session = qi.Session()
        try:
            session.connect("tcp://" + args.ip + ":" + str(args.port))
        except RuntimeError:
            print ("Can't connect to Naoqi at ip \"" + args.ip + "\" on port " + str(args.port) +".\n"
                   "Please check your script arguments. Run with -h option for help.")
            sys.exit(1)
        main(session)

To execute this script, type:

    python alanimationplayer_tutorial_runcontextual.py --qi-url=tcp://<robot name or robot id>:9559

Glossary Site map Index Support Contact Legal Notices