Speech recognition using Google

  • This tutorial assumes that RAPP API is installed and built
  • This tutorial uses the 0.7.0 version of the C++ API

In this tutorial we are going to recognise the speech from an audio using Google, RAPP and CMake.

You have to configure your project in like this tree:


Source code

We created a project called speech_recognition_google with a folder source where we have our example call speech_recognition_google.cpp. You can see the complete example here.

We are going to initialize the platform information and the service controller, which is in charge of make the cloud calls to the RAPP platform:

rapp::cloud::platform info = {"rapp.ee.auth.gr", "9001", "rapp_token"}; 
rapp::cloud::service_controller ctrl(info);

The callback for this example need vectors of string to save the words that have been recognised and the possible alternatives.

auto callback = [&](std::vector<std::string> words, 
                    std::vector<std::vector<std::string>> alternatives) 
        if (words.size() != 0) {
            std::cout << "Words: " << std::endl;
            for (auto each_word : words) {
                std::cout << each_word << std::endl;
        else {
            std::cout << "No words found" << std::endl;
        if (alternatives.size() != 0) {
            std::cout << "Alternatives: " << std::endl;
            std::cout << alternatives.size() << "found" << std::endl;
        else {
            std::cout << "No alternatives found" << std::endl;

If we see the documentation of the class rapp::cloud::speech_recognition_google, we'll see that an audio and its type are necessary.

rapp::object::audio audio("../data/object_classes_audio_4.ogg");
rapp::types::audio_source audio_src = rapp::types::nao_ogg;

NOTE: audio_source is a enum. You can find the different types of audio in rapp-api/cpp/rapp/objects/globals.hpp

Finally, we can make the call to the platform.

ctrl.make_call<rapp::cloud::speech_recognition_google>(audio.bytearray(), audio_src, "en", callback);

Besides the audio and the callback you need to indicate the language, in this case English "en".


In this case it assumes that you have built your RAPP API in the static and shared libraries mode.

We haven't added any new library to do this example, so the CMakeLists.txt is the same that getting_started examples.

You only have to change the name of your source file and the executable.


The next step is about create our build folder and run our code.

Now we are going to work in the terminal.

  1. Go to your project path
  2. Build your project

    mkdir build
    cd build 
    cmake ..
  3. If everything is ok, you will have created your executable speech_recognition_google in the folder build.
  4. Run your executable

Now you can explore and make your own projects!