Understanding Alerts

• Overview
• Scenario 1: Set a Timer with Voice
• Scenario 2: Cancel an Alarm Using the Amazon Alexa App
• Scenario 3: Set a Recurring Alarm
• Scenario 4: Snooze a Sounding Alarm
• Lifecycle Events
• Next Steps
• Resources

Overview

alerts에 관해서, 사용자는 일반적으로 타이머 설정, alert 설정 또는 타이머 또는 alert 삭제 / 취소의 세 가지 방법 중 하나로 Alexa 사용 가능 제품과 상호 작용합니다. 사용자가 타이머 또는 알람을 설정하려면 제품에 활성 인터넷 연결이 있어야합니다. 

이 작업은 제품에 조치 (예 : SetAlert 및 DeleteAlert)를 지시하고 Alexa Voice Service (AVS)에 조치가 취해 졌음을 알리는 이벤트

 (예 : SetAlertSucceeded 및 DeleteAlertSucceeded)를 전송하는 데 필요합니다.

인터넷 연결이 끊어지면 제품에 이전에 설정된 타이머 또는 alert을 처리 할 수 있어야합니다. 

예를 들어, 사용자가 오전 7시 30 분에 알람을 설정하면 잠자기 전에 제품이 밤 사이에 인터넷 연결이 끊어지면 제품에 오전 7시 30 분에 알림을 재생할 수있는 기능이 있어야합니다. 인터넷 연결이 끊어진 후 타이머 및 알람을 실행하면 긍정적인 사용자 환경이 보장됩니다.

제품의 시계를 관리하는 것은 타이머와 alert이 설계된대로 작동하도록하는 데 중요합니다. 

AVS에서 보낸 모든 directive는 UTC 시간에 반환됩니다. 사용자가 제품에 "3 분 동안 타이머 설정"을 지시하면 AVS는 해당 사용자의 시간대를 고려하여 요청에 해당하는 올바른 UTC 시간을 결정합니다. 제품의 시간이 현지에서 조정 된 경우 타이머 및 알람이 제대로 작동하지 않을 수 있습니다. 이러한 이유로 아마존은 시계 동기화에 NTP (Network Time Protocol)를 사용하도록 제안합니다.

정전 또는 재부팅이 필요한 경우 제품에 alert을 유지하고 복원 할 수 있어야합니다. 

향후 alert가 예정된 경우 제품에서 alert을 로컬로 설정해야합니다.

 귀하의 제품은 alert가 다시 설정되었음을 Alexa에 알리는 이벤트를 전송할 필요가 없습니다. 

alert가 해제 될 때 제품 전원이 꺼지거나 재부팅되는 경우 다음 규칙을 따라야합니다.

• 지난 30 분 내에 alert가 예정된 경우 제품에서 alert를 트리거하고 모든 해당 이벤트를 보내야합니다.
• alert가 예정된 수행에서 30 분 이상 경과하면 이를 폐기해야하며 제품은 각 폐기 alert에 대해 AVS에 AlertStopped 이벤트를 보내야합니다.

Alexa 기반 제품은 다음과 같이 요약 할 수 있습니다.

• 인터넷 연결이 끊어지면 이전에 설정된 alert를 처리 할 수 있어야합니다.
• 네트워크 시간 프로토콜을 사용하여 제품의 시계를 관리하십시오.
• 제품의 전원이 꺼 지거나 재부팅되는 경우 이전에 설정된 alert를 처리 할 수 있어야합니다.

다음 예제는 타이머 및 알람이 AVS와 함께 작동하는 방법을 이해하는 데 사용해야합니다. 

이러한 시나리오는 다음을 가정합니다.

• 귀하의 제품은 사용자의 말을 처리하고 AVS로부터받은 지침에 따라 행동하도록 고안되었습니다.
• 귀하의 제품은 클라우드 기반 지시문을 수신하는 다운 채널을 구축했습니다. 

          자세한 내용은 AVS를 사용하여 HTTP / 2 연결 관리를 참조하십시오.

• 이벤트가 발생하면 제품에서 AVS를 업데이트합니다.
• 모든 이벤트는 개별 이벤트 스트림으로 전송됩니다.

Scenario 1: Set a Timer with Voice

사용자가 5 분 동안 타이머를 설정하려고합니다. 

사용자가 "5 분 동안 타이머 설정"이라고 말하면 제품은 사용자의 음성을 캡처하고 AVS에 인식 이벤트를 전송해야합니다. 

그런 다음 AVS는 제품에 수행 할 작업을 지시하는 일련의 directive로 응답하고 제품은 조치를 취해야합니다. 

익숙한 것 같습니다. 타이머나 alert을 설정하는 것은 제품과 AVS 간의 표준 상호 작용 모델을 따르기 때문입니다. 

질문을하거나 요청을하고 응답을 받고 그에 따라 행동하고 AVS에 문제가 발생했음을 업데이트하십시오.

이것은 타이머를 설정할 때의 메시지 흐름입니다.

• 사용자가 타이머 설정을 요청하면 AVS는 Speak Directive를 보내 제품에 연결된 오디오를 재생하도록 지시합니다. 

     이 시나리오에서는 "5 분, 지금 시작하십시오."알렉사 speech의 재생이 시작되면 제품에서 AVS로 SpeechStarted 이벤트를 보내야합니다.

• Alexa speech의 재생이 완료되면 SpeechFinished 이벤트를 AVS에 보내야합니다.
• 또한 AVS는 다운 채널 스트림에서 제품에 SetAlert 지정 문을 전송합니다. 제품 타이머는 5 분 동안 설정되어야하며 SetAlertSucceeded 이벤트는 AVS로 전송되어야합니다. 제품에는 타이머 설정 및 타이머 만료에 필요한 논리가 있어야합니다.
• 5 분이 경과 한 후 제품은 타이머가 만료되었음을 사용자에게 알리고 AlertStarted 이벤트를 AVS로 보내야합니다.

사용자는 음성 또는 Amazon Alexa 앱을 사용하여 타이머를 중지 할 수 있어야하며 가능한 경우 물리적 컨트롤 (버튼 또는 GUI)을 통해 타이머를 중지 할 수 있어야합니다.

• 요청이 음성 또는 Amazon Alexa 앱을 통해 이루어지면 AVS는 제품에 DeleteAlert Directive를 보냅니다. 이 때 제품은 AlertStopped 이벤트와 DeleteAlertSucceeded 이벤트를 AVS에 보내야 합니다.
• button affordance 결과로 타이머가 중지되면 제품은 AlertStopped 이벤트를 AVS로 전송해야합니다.

올바르게 구현 된 경우 타이머가 제품에 설정되면 인터넷 연결없이 작동해야합니다. 

그러나 이벤트가 발생했음을 AVS에 알리는 연결이 필요합니다. 

따라서 인터넷 연결이 다시 설정되면 제품 상태에서 AVS를 업데이트하는 데 필요한 논리가 제품에 있어야합니다.

아래의 시퀀스 다이어그램은 타이머가 설정된 경우 제품과 AVS 간의 예상되는 상호 작용을 보여줍니다.

Scenario 2: Cancel an Alarm Using the Amazon Alexa App

이 시나리오에서는 alert가 성공적으로 설정되었고 사용자가 해당 alert를 취소하려고한다고 가정해야합니다.

사용자는 Amazon Alexa 앱을 열어 모든 제품 별 알람 (활성 및 비활성)에 액세스 할 수 있습니다. 

사용자는 알람으로 이동하고 오전 7시 30 분에 설정된 알람을 취소합니다.

DeleteAlert directive는 다운채널 스트림으로 제품으로 전송됩니다. 지금까지 모든 사용자 조치가 Amazon Alexa 앱에서 발생했습니다.

DeleteAlert directvie를 받으면 제품에서 directive에 따라 행동하고 오전 7시 30 분에 설정된 경보를 취소 할 수 있어야합니다. 

여기에는 알람이 삭제 된 후 AVS에 DeleteAlertSucceeded 이벤트를 보내는 작업이 포함됩니다.

이 시퀀스 다이어그램은 Amazon Alexa 앱을 사용하여 알람을 취소 한 경우 제품과 AVS 간의 예상되는 상호 작용을 보여줍니다.

Scenario 3: Set a Recurring(순환하는) Alarm

제품에 반복적인 알람을 설정하는 과정은 타이머 설정과 유사합니다. 

directive와 event의 흐름은 거의 동일합니다 (시나리오 1 참조). 

유일한 차이점은 반복 알람이 취소 될 때까지 AVS가 매일 새 SetAlert directive를 제품에 보냅니다.

이 시퀀스 다이어그램은 반복 알람이 설정 될 때 제품과 AVS 간의 예상되는 상호 작용을 보여줍니다.

Scenario 4: Snooze a Sounding Alarm

이 시나리오에서는 alert가 성공적으로 설정되었고 현재 소리가 나는 것으로 가정해야합니다.

중요 : 다시 알림은 음성으로 만 시작할 수 있습니다.

알람이 울리고 사용자가 "Alexa, snooze"라고 말하면 몇 가지 일이 발생합니다. 

사용자 음성이 AVS로 스트리밍되고 업데이트 된 예약 시간이있는 새 SetAlert directive가 제품으로 전송됩니다. 

귀하의 제품은 울리는 alert의 토큰과 새로운 SetAlert directive가 일치하는지 확인해야합니다. 

토큰이 일치하면 제품에서 경고음을 취소하고 SetAlert directive의  payload에 포함 된 scheduledTime에 대한 새 알람을 설정해야합니다.

이 시퀀스 다이어그램은 알람이 일시 중지 된 경우 제품과 AVS 간의 예상되는 상호 작용을 보여줍니다.

Lifecycle Events

이 표는 제품이 AVS에 보내야하는 네 가지 사용자 조치 및 라이프 사이클 이벤트를 제공합니다.

참고 : DeleteAlertSucceeded 또는 DeleteAlertFailed는 DeleteAlert directive에 대한 응답으로만 전송됩니다. 

로컬로 수행 된 작업에 대해 이러한 이벤트를 보내지 마십시오.

User Action	Server Behavior	Alert is Active (Making Noise)	Send AlertStarted	Send AlertStopped	Send DeleteAlertSucceeded / DeleteAlertFailed
User says: “Stop Alert.”	DeleteAlert를downchannel stream에서 전송.	Y	Y	Y	Y
사용자는 실제 컨트롤 (버튼 또는 GUI)을 사용하여 활성 alert를 로컬에서 중지합니다.	None	Y	Y	Y	N
사용자가 음성 요청 또는 Amazon Alexa 앱을 통해 비활성 알림을 취소합니다.	DeleteAlertdiretive 를 downchannel stream에서 전송.	N	N	N	Y
재생하지 않고 알람이 만료되었습니다  (예 : 예정된 이행 시간에 기기의 전원이 켜지지 않음)	None	N	N	Y	N

참고 : https://developer.amazon.com/public/solutions/alexa/alexa-voice-service/reference/timers-and-alarms-conceptual-overview#overview