Smart Home Security Overview
You can use the Alexa
APIs to create Alexa skills that control smart home security devices such as cameras, locks, motion sensors, and other devices. You create smart home security skills the same way you create any other smart home skill. For more information, see Understand the Smart Home Skill API and Steps to Build a Smart Home Skill.
You can build an Alexa skill for cloud-enabled cameras that stream video and audio using Web Real-Time Communication (WebRTC) or the Real Time Streaming Protocol (RTSP). We recommend that you use WebRTC whenever possible. If you want to support 2-way communication, you must use Alexa.RTCSessionController.
The Smart Home Skill API follows the OAuth2.0 specification. Every request sent from the Smart Home Skill API to a smart home skill contains an OAuth access token in the request to enable access to the customer's device cloud. The device cloud must support the authorization code grant flow type. For more information, see Account Linking for Smart Home and Other Domains.
Utterances
When you use the Alexa
interfaces to build smart home skills, the voice interaction model is already built for you. The following examples show some user utterances:
Alexa, talk to my front door camera.
Alexa, lock my front door.
Alexa, arm my home in away mode.
Alexa interfaces for smart home security skills
The following are the Alexa
interfaces that you can use to build smart home security skills.
- Alexa.CameraStreamController
- Implement the
CameraStreamController
interface so that users can view the feed from their security cameras. - Alexa.ContactSensor
- Implement the
ContactSensor
interface for devices that detect contact between two surfaces. - Alexa.DoorbellEventSource
- The
DoorbellEventSource
interface describes a device that is capable of raising doorbell events. - Alexa.EventDetectionSensor
- Implement the
EventDetectionSensor
interface so that you can notify Alexa when your security camera devices detect the presence of a person. - Alexa.LockController
- Implement the
LockController
interface so that users can lock and unlock their lockable devices. - Alexa.MediaMetadata
- Implement the
MediaMetadata
interface to manage media recordings from security cameras, and so that customers can view past recordings. - Alexa.MotionSensor
- Implement the
MotionSensor
interface for devices that sense physical movement in an area. - Alexa.RTCSessionController
- Implement the
RTCSessionController
interface for devices capable of real-time communication (RTC), so that users can communicate remotely with their devices. - Alexa.SecurityPanelController
- Implement the
SecurityPanelController
interface so that users can arm and disarm security systems, and so that you can report alarm conditions to your users.
Works with Alexa Guidelines
Works with Alexa (WWA) is a certification program that raises the bar on responsiveness, reliability, and functionality, ensuring your customers have the best smart home experiences. When your products are certified, they can carry the Works with Alexa badge in the Amazon Smart Home Store and on product packaging. For details, see Works with Alexa Overview.