[Huawei Developers] BegumAvci:
View attachment 5293907

Hi everyone, in this article, we will talking about the use of Huawei Voice (HiVoice) Assistant with App Ability. Firstly I want to explain;

Who is Celia ?​

Celia is the voice assistant of your Huawei phone. Celia on your devices can help you ; make a phone call, set an alarm, send a message, set a reminder, play music, play video and more. Celia is ready on Huawei Phones, Smart TVs, Speakers, Watches.

Currently, you can communicate with AI Voice in English, French, and Spanish in the UK, France, Spain, Chile, Mexico, and Colombia.

To set your country and region, and the system language you want to use, go to Settings > System & updates > Language & input > Language and region . AI Voice can only be woken up if you select one of the above countries.

You can select a language for communicating with AI Voice from the settings menu by touching in full screen in AI Voice. Currently, only English, French, and Spanish are supported.

When Can I Interact With AI Voice?​

To wake up AI Voice, press and hold the Power button for 1 second. AI Voice can be in an idle, listening, or thinking state. It only takes commands when it is listening.

· Idle: AI Voice does not take voice commands in this state.

· Listening: AI Voice can communicate with you in this state.

· Thinking: AI Voice is carrying out your commands and doesn’t take new commands in this state.

View attachment 5293909

Note: You cannot wake up AI Voice when your device is in a call and AI Voice with the wakeup word when your device is making an audio or screen recording. However, you can still use the Power button to wake up AI Voice.

Service Introduction​

You can use AI Voice in many areas. You can access with deeplinks. Now I will explain the different usage scenarios for you.

News : We should offer title, abstract and hyperlinks of news. And also offer Playing Interface so that voice and video news could be played by Celia. For example, when Celia is launching news App, she would ask the app to start playing.

Search For News : We can perform the search process by specifying the news type, time, the application that the news is published and the content type of the news. If the news we are looking for is in the application loaded on our phone, it shows us the result in the content and can go to the news content when clicked. If the app is not exist on the phone, it directs us to AppGallery.

Play News : We can open the news we want by first saying play and then telling the news tour, time, application name and content. For example ; Jump to BBC news to play the news: If there are more than one content provider, the latest used provider will be selected. If the app is not exist on the phone, it directs us to AppGallery.

Pause News : If there is a news thread running and we call it “stop playing,” Celia detects it and stops the application. If there is no news in the playlist, no news content is playing.

Continue Playing News : If there is a news that is half-finished to listen, when we say “continue playing news”, the news continues to play from where it left off. It is recommended if there is no late news or if there is a channel you listen to regularly.

Next News : If the user wants to go to the next article, they can listen to the next news by saying “next — news type — news”.

Music : We need to songs database of all categories. Provide deeplink or API that allow Celia to search & play music, whether user just want to listen randomly, or by specific artist, album, song name, music genre or combination slots.

Basic Music Play : If people can ask “sing me a song”, “play music” and if the song exist it will be started.

Play by Song Name or Artist : If people can ask “play -song name-” and “play -artist name” jump and play asked song or play by artist.

Play by Album or Music Genre : If people can ask “play -album name-” or “play me something -mood-” , jump and play asked album or play the asked music.

Music Play Control : Previous song, next song, play another song, please , change the song, skip this song ,pause, stop playing by detecting these commands and act as what people asked without app jump or system unlock.

Navigation : We should provide point of Interest information to Huawei, such as street names, building names, etc. to help identify these instances, global map data, multiple countries services and languages we cover content. And we offer deeplink for functions of navigation, route, address, etc. for the interface.

Navigate to Somewhere : If people can ask “navigate to -somewhere-”, “I need to get to nearest gas station”, “take me to the nearest hospital” and Celia told you will go to maps start navigation, jump to the maps and start navigation.

Search for Route to Somewhere : If people can ask “Give me the route to The Times Square by bike”, “Give me the route to go to work”, “4、Tell me how to get from the Brooklyn Bridge to the United Nations” Celia told you will go to maps and show the route and jump to the maps and show the route.

Web Search : For the web search we need to search lists with embedded card in Celia without jumping to Huawei browser and provide API of search function as a interface. We can search content, application, in search engine content. For Example ; People can ask： “search JK Rowling on the web”, show search lists with embedded card and click item jump to detail page

Configuration​

If we want to use app ability in our project we need to do some configurations. You can find configuration page here.

To start we click to “Create ability” button on the Smart Service pages on console.

View attachment 5293911

We need to select ability model click this area.

View attachment 5293913

We fill the information of our application in the spaces below and click “Create Button”

View attachment 5293915

We fill the information of our application in the spaces below in our Android Studio Project.

View attachment 5293917

We select in which countries ability will be available

View attachment 5293919

We write properties of ability that will be visible to the user. Or if we had a template we update this.

View attachment 5293921

The next step is configure. In the Configure page wee need to “Add user intent” for App Ability — AI Voice.

View attachment 5293923

In this section, we define how the user will find what he / she will search for. We need to create the fullfilment1 by selecting the intent name, its category, determining how and with which words it will be triggered, how it will be triggered. And we need to define the words trigger in the language of that country in which countries will be publish.

View attachment 5293925

After that we need to configure fulfillment for associate intents with our ability. We need to select fulfillment type. If we redirect to website we choose Web service or if we had a application and want to redirect app we need to choose APK/RPK/FA/H5 link. Or if we had existing fulfillment for same app we can use too.

View attachment 5293929

We add to properties of the application and the deeplink of the page to be redirected. If the application is not published from the same developer account, it will not appear in the App section. Therefore, the application must be live in order to create fulfillment.

View attachment 5293931

When all the steps is finished we need to testing out app.

View attachment 5293933

Final state of running ability after all steps have been successfully completed;

You can find video this link ; Testing App Ability