About smart home

Smart home skills are a special category of Yasmina skills that are intended to control your home devices by voice. For example, a user can ask Yasmina to turn on the kettle, set the heater to a certain temperature, turn off the light in the children's room, or turn down the TV.

Smart home skills don't require an activation phrase: they work as built-in Yasmina scripts. For example: “Yasmina, turn on the light in the kitchen”.

You need to link accounts to use smart home skills. To control smart devices from a certain manufacturer, like Xiaomi, the skill must have access to the user's account in that manufacturer's system. You need to link the user's Yango account to the user's account in the manufacturer's system for the skill to work.

When the user clicks Link to Yango, they are redirected to the login page. After the user logs in to the smart home system and grants access, they are redirected back to the search app interface.

Dialogs communicate with skills and smart home systems via the OAuth 2.0 protocol, using authorization codes (authorization code grant). The authorization server can be incorporated into the smart home system, or it can be used as a third-party service.

To implement authorization in a smart home skill, you need to define the OAuth protocol parameters and link accounts.

Before you start designing a skill, check out the smart home management concept.