はじめに
別の記事でNode.js版のAlexaスキルの最小構成のテンプレートについて書きましたが、C#のテンプレートも必要だよね、ということです。
(2018年11月7日修正:C#のプログラムを修正しました。変更前の方法だと、あとで同一セッション内のデータ保持をしようとすると、~IntentHandlerメソッド側でセッションアトリビュートを取得できないことがわかったためです。すみません。
なので、skillRequest
を各~IntentHandlerメソッドにまるごと渡すようにしました。 )
こちらはNode.js版の最小構成です。
/* eslint-disable func-names */
/* eslint-disable no-console */
const Alexa = require('ask-sdk-core');
const LaunchRequestHandler = {
canHandle(handlerInput) {
return handlerInput.requestEnvelope.request.type === 'LaunchRequest';
},
handle(handlerInput) {
const speechText = 'Welcome to the Alexa Skills Kit, you can say hello!';
return handlerInput.responseBuilder
.speak(speechText)
.reprompt(speechText)
.withSimpleCard('Hello World', speechText)
.getResponse();
},
};
const HelloWorldIntentHandler = {
canHandle(handlerInput) {
return handlerInput.requestEnvelope.request.type === 'IntentRequest'
&& handlerInput.requestEnvelope.request.intent.name === 'HelloWorldIntent';
},
handle(handlerInput) {
const speechText = 'Hello World!';
return handlerInput.responseBuilder
.speak(speechText)
.withSimpleCard('Hello World', speechText)
.getResponse();
},
};
const HelpIntentHandler = {
canHandle(handlerInput) {
return handlerInput.requestEnvelope.request.type === 'IntentRequest'
&& handlerInput.requestEnvelope.request.intent.name === 'AMAZON.HelpIntent';
},
handle(handlerInput) {
const speechText = 'You can say hello to me!';
return handlerInput.responseBuilder
.speak(speechText)
.reprompt(speechText)
.withSimpleCard('Hello World', speechText)
.getResponse();
},
};
const CancelAndStopIntentHandler = {
canHandle(handlerInput) {
return handlerInput.requestEnvelope.request.type === 'IntentRequest'
&& (handlerInput.requestEnvelope.request.intent.name === 'AMAZON.CancelIntent'
|| handlerInput.requestEnvelope.request.intent.name === 'AMAZON.StopIntent');
},
handle(handlerInput) {
const speechText = 'Goodbye!';
return handlerInput.responseBuilder
.speak(speechText)
.withSimpleCard('Hello World', speechText)
.getResponse();
},
};
const SessionEndedRequestHandler = {
canHandle(handlerInput) {
return handlerInput.requestEnvelope.request.type === 'SessionEndedRequest';
},
handle(handlerInput) {
console.log(`Session ended with reason: ${handlerInput.requestEnvelope.request.reason}`);
return handlerInput.responseBuilder.getResponse();
},
};
const ErrorHandler = {
canHandle() {
return true;
},
handle(handlerInput, error) {
console.log(`Error handled: ${error.message}`);
return handlerInput.responseBuilder
.speak('Sorry, I can\'t understand the command. Please say again.')
.reprompt('Sorry, I can\'t understand the command. Please say again.')
.getResponse();
},
};
const skillBuilder = Alexa.SkillBuilders.custom();
exports.handler = skillBuilder
.addRequestHandlers(
LaunchRequestHandler,
HelloWorldIntentHandler,
HelpIntentHandler,
CancelAndStopIntentHandler,
SessionEndedRequestHandler
)
.addErrorHandlers(ErrorHandler)
.lambda();
こちらはC#版の最小構成です。
using Alexa.NET.Request;
using Alexa.NET.Request.Type;
using Alexa.NET.Response;
using Amazon.Lambda.Core;
using System;
// Assembly attribute to enable the Lambda function's JSON input to be converted into a .NET class.
[assembly: LambdaSerializer(typeof(Amazon.Lambda.Serialization.Json.JsonSerializer))]
namespace MinimumAlexaSkill_CSharp
{
public class Function
{
/// <summary>
/// A simple function that takes a string and does a ToUpper
/// </summary>
/// <param name="skillRequest"></param>
/// <param name="context"></param>
/// <returns></returns>
public SkillResponse FunctionHandler(SkillRequest skillRequest, ILambdaContext context)
{
SkillResponse skillResponse = null;
try
{
//型スイッチの利用
switch (skillRequest.Request)
{
case LaunchRequest launchRequest:
skillResponse = LaunchRequestHandler(skillRequest);
break;
case IntentRequest intentRequest:
switch (intentRequest.Intent.Name)
{
case "HelloWorldIntent":
skillResponse = HelloWorldIntentHandler(skillRequest);
break;
case "AMAZON.HelpIntent":
skillResponse = HelpIntentHandler(skillRequest);
break;
case "AMAZON.CancelIntent":
skillResponse = CancelAndStopIntentHandler(skillRequest);
break;
case "AMAZON.StopIntent":
skillResponse = CancelAndStopIntentHandler(skillRequest);
break;
default:
//skillResponse = ErrorHandler(skillRequest);
break;
}
break;
case SessionEndedRequest sessionEndedRequest:
skillResponse = SessionEndedRequestHandler(skillRequest);
break;
default:
//skillResponse = ErrorHandler(skillRequest);
break;
}
}
catch (Exception ex)
{
skillResponse = ErrorHandler(skillRequest);
}
return skillResponse;
}
#region 各インテント、リクエストに対応する処理を担当するメソッドたち
private SkillResponse LaunchRequestHandler(SkillRequest skillRequest)
{
var launchRequest = skillRequest.Request as LaunchRequest;
var speechText = "Welcom to the Alexa Skills Kit, you can say hello!";
var skillResponse = new SkillResponse
{
Version = "1.0",
Response = new ResponseBody()
};
skillResponse.Response.OutputSpeech = new PlainTextOutputSpeech
{
Text = speechText
};
skillResponse.Response.Reprompt = new Reprompt
{
OutputSpeech = new PlainTextOutputSpeech
{
Text = speechText
}
};
skillResponse.Response.Card = new SimpleCard
{
Title = "Hello World",
Content = speechText
};
return skillResponse;
}
private SkillResponse HelloWorldIntentHandler(SkillRequest skillRequest)
{
var intentRequest = skillRequest.Request as IntentRequest;
var speechText = "Hello World!";
var skillResponse = new SkillResponse
{
Version = "1.0",
Response = new ResponseBody()
};
skillResponse.Response.OutputSpeech = new PlainTextOutputSpeech
{
Text = speechText
};
skillResponse.Response.Card = new SimpleCard
{
Title = "Hello World",
Content = speechText
};
skillResponse.Response.ShouldEndSession = true;
return skillResponse;
}
private SkillResponse HelpIntentHandler(SkillRequest skillRequest)
{
var intentRequest = skillRequest.Request as IntentRequest;
var speechText = "You can say hello to me!";
var skillResponse = new SkillResponse
{
Version = "1.0",
Response = new ResponseBody()
};
skillResponse.Response.OutputSpeech = new PlainTextOutputSpeech
{
Text = speechText
};
skillResponse.Response.Reprompt = new Reprompt
{
OutputSpeech = new PlainTextOutputSpeech
{
Text = speechText
}
};
skillResponse.Response.Card = new SimpleCard
{
Title = "Hello World",
Content = speechText
};
return skillResponse;
}
private SkillResponse CancelAndStopIntentHandler(SkillRequest skillRequest)
{
var intentRequest = skillRequest.Request as IntentRequest;
var speechText = "Goodbye!";
var skillResponse = new SkillResponse
{
Version = "1.0",
Response = new ResponseBody()
};
skillResponse.Response.OutputSpeech = new PlainTextOutputSpeech
{
Text = speechText
};
skillResponse.Response.Card = new SimpleCard
{
Title = "Hello World",
Content = speechText
};
skillResponse.Response.ShouldEndSession = true;
return skillResponse;
}
private SkillResponse SessionEndedRequestHandler(SkillRequest skillRequest)
{
var sesstionEndedRequest = skillRequest.Request as SessionEndedRequest;
return new SkillResponse
{
Version = "1.0",
Response = new ResponseBody()
};
}
private SkillResponse ErrorHandler(SkillRequest skillRequest)
{
var speechText = "Sorry, I can't understand the command. Please say again.";
var skillResponse = new SkillResponse
{
Version = "1.0",
Response = new ResponseBody()
};
skillResponse.Response.OutputSpeech = new PlainTextOutputSpeech
{
Text = speechText
};
skillResponse.Response.Reprompt = new Reprompt
{
OutputSpeech = new PlainTextOutputSpeech
{
Text = speechText
}
};
return skillResponse;
}
#endregion
}
}
確認
このエンドポイントの動作を確認するための対話モデルを作成します。
スキル名を「HelloWorldSkill」とします。
カスタムスキルです。
カスタムインテントを追加します。
プログラム側に合わせて「HelloWorldIntent」とします。
対話モデルをビルドします。
エンドポイントの設定で、対話モデルのスキルIDをコピーします。
AWS Lambda側に貼り付けて保存します。
AWS LambdaのARNをコピーします
対話モデル側のエンドポイントとして「デフォルトの地域」の欄に貼り付け、エンドポイントを保存します。
テストしてみましょう。
「テスト」タブでテストを有効にして、呼び出し名「ハローワールド」を入力します。
LaunchRequestの応答が返ってきますね。
そのまま「HelloWorldIntent」を呼び出してみましょう。
HelloWorldIntentの応答が返ってきました。
ちゃんと動作しているようです。
おわりに
Node.js版のテンプレートをC#で書き直してみました。
できるだけシンプルに書いてみました。
C#で何かAlexaスキルを作る、という方はこれをたたき台として使ってみても良いかもしれません。
また、こうやって一度整理することで、C#での書き方の理解が進みました。