スキルコードにAPLサポートを追加する

// RequestHelperクラスを使用
import com.amazon.ask.request.RequestHelper;
// （その他のインポートはここで）

public class HelloWorldIntentHandler implements RequestHandler {

    @Override
    public boolean canHandle(HandlerInput input) {
        // このハンドラーを使用するかどうかを判断するロジック
    }

    @Override
    public Optional<Response> handle(HandlerInput input) {
        // ...すべてのデバイスで使用されるその他のコード

        // ユーザーのデバイスがAPL対応かどうかを確認
        if (RequestHelper.forHandlerInput(input)
                .getSupportedInterfaces()
                .getAlexaPresentationAPL() != null) {

            // APLディレクティブの送信コードをここに配置
        }
    }
}

package handlers;

import static com.amazon.ask.request.Predicates.intentName;
import static util.Constants.HELLO_WORLD_TOKEN; // String "helloworldToken"

import java.io.File;
import java.io.IOException;
import java.util.HashMap;
import java.util.Map;
import java.util.Optional;

import com.amazon.ask.dispatcher.request.handler.HandlerInput;
import com.amazon.ask.dispatcher.request.handler.RequestHandler;
import com.amazon.ask.exception.AskSdkException;
import com.amazon.ask.model.Response;
import com.amazon.ask.model.interfaces.alexa.presentation.apl.RenderDocumentDirective;
import com.amazon.ask.request.RequestHelper;
import com.amazon.ask.response.ResponseBuilder;
import com.fasterxml.jackson.core.type.TypeReference;
import com.fasterxml.jackson.databind.ObjectMapper;

public class HelloWorldIntentHandler implements RequestHandler {

    @Override
    public boolean canHandle(HandlerInput input) {
        return input.matches(intentName("HelloWorldIntent"));
    }

    @Override
    public Optional<Response> handle(HandlerInput input) {
        String speechText = "ハローワールド";
        ResponseBuilder responseBuilder = input.getResponseBuilder();

        if (RequestHelper.forHandlerInput(input)
                .getSupportedInterfaces()
                .getAlexaPresentationAPL() != null) {
            try {
                // JSONドキュメントを取得し、文字列とオブジェクトをマッピングにする
                ObjectMapper mapper = new ObjectMapper();
                TypeReference<HashMap<String, Object>> documentMapType = 
                    new TypeReference<HashMap<String, Object>>() {};

                Map<String, Object> document = mapper.readValue(
                    new File("helloworldDocument.json"), 
                    documentMapType);

                // SDKのビルダーメソッドを使用してディレクティブを作成する
                RenderDocumentDirective renderDocumentDirective = RenderDocumentDirective.builder()
                        .withToken(HELLO_WORLD_TOKEN)
                        .withDocument(document)
                        .build();

                // ディレクティブをresponseBuilderに追加する
                responseBuilder.addDirective(renderDocumentDirective);

                // 発話を画面付きデバイス向けにする
                speechText += "これでご挨拶が画面でも表示されるようになりました。";

            } catch (IOException e) {
                throw new AskSdkException("ハローワールドドキュメントの読み込み、または逆シリアル化に失敗しました", e);
            }
        } else {
            // デバイスに画面がないため、発話出力を変更する
            speechText += "このサンプルをEcho ShowやFire TVのような画面付きデバイスで実行すると、もっと面白いことが起こります。";
        }

        // 発話を追加して応答を返す

        return responseBuilder
            .withSpeech(speechText)
            .withSimpleCard("APLを使用したハローワールド", speechText)
            .build();
    }

}

package handlers;

import static com.amazon.ask.request.Predicates.intentName;
import static util.Constants.HELLO_WORLD_WITH_BUTTON_TOKEN; // String "helloworldWithButtonToken"

import java.io.File;
import java.io.IOException;
import java.util.HashMap;
import java.util.Map;
import java.util.Optional;

import com.amazon.ask.dispatcher.request.handler.HandlerInput;
import com.amazon.ask.dispatcher.request.handler.RequestHandler;
import com.amazon.ask.exception.AskSdkException;
import com.amazon.ask.model.Response;
import com.amazon.ask.model.interfaces.alexa.presentation.apl.RenderDocumentDirective;
import com.amazon.ask.request.RequestHelper;
import com.amazon.ask.response.ResponseBuilder;
import com.fasterxml.jackson.core.type.TypeReference;
import com.fasterxml.jackson.databind.ObjectMapper;

public class HelloWorldWithButtonIntentHandler implements RequestHandler {

    @Override
    public boolean canHandle(HandlerInput input) {
        return input.matches(intentName("HelloWorldWithButtonIntent"));
    }

    @Override
    public Optional<Response> handle(HandlerInput input) {
        String speechText = "ハローワールド";
        ResponseBuilder responseBuilder = input.getResponseBuilder();

        if (RequestHelper.forHandlerInput(input)
                .getSupportedInterfaces()
                .getAlexaPresentationAPL() != null) {
            try {
                // ハローワールドAPLドキュメントを含むJSONファイルを
                //「resources」フォルダから取得し、
                //  ディレクティブに追加する
                ObjectMapper mapper = new ObjectMapper();
                TypeReference<HashMap<String, Object>> documentMapType = new TypeReference<HashMap<String, Object>>() {
                };
                Map<String, Object> document = mapper.readValue(new File("helloworldWithButtonDocument.json"), documentMapType);

                // ディレクティブをビルドする
                RenderDocumentDirective renderDocumentDirective = RenderDocumentDirective.builder()
                    .withToken(HELLO_WORLD_WITH_BUTTON_TOKEN)
                    .withDocument(document)
                    .build();
                
                responseBuilder.addDirective(renderDocumentDirective);
                            
                // 発話を更新して画面について言及する
                speechText += "Alexa Presentation Languageへようこそ。ボタンを押して動作を確認してください。";

            } catch (IOException e) {
                throw new AskSdkException("ハローワールドドキュメントの読み込み、または逆シリアル化に失敗しました", e);
            }

        } else {
            speechText += "このサンプルをEcho ShowやFire TVのような画面付きデバイスで実行すると、もっと面白いことが起こります。";
        }

        return responseBuilder
            .withSpeech(speechText)
            .withSimpleCard("APLを使用したハローワールド", speechText)
            .build();
    }
}

package handlers;

import java.util.Map;
import java.util.Optional;

import com.amazon.ask.dispatcher.request.handler.HandlerInput;
import com.amazon.ask.dispatcher.request.handler.impl.UserEventHandler;
import com.amazon.ask.model.Response;
import com.amazon.ask.model.interfaces.alexa.presentation.apl.UserEvent;

public class HelloWorldButtonEventHandler implements UserEventHandler {

    @Override
    public boolean canHandle(HandlerInput input, UserEvent userEvent) {      
        // これは型指定のあるハンドラーであるため、UserEvent専用として実行されます。
        // APLスキルにはUserEventを生成するボタンが複数存在することがあるため、
        // このイベントをトリガーしたボタン操作をイベントソースIDで判断し、
        // 適切なハンドラーを使用します。このサンプルで
        // 設定されているIDの文字列は「fadeHelloTextButton」です。

        // userEvent.getSource()メソッドはObjectを返します。Mapにキャストすることで
        // idを取得できます。
        Map<String,Object> eventSourceObject = (Map<String,Object>) userEvent.getSource();
        String eventSourceId = (String) eventSourceObject.get("id");
        return eventSourceId.equals("fadeHelloTextButton");
    }

    @Override
    public Optional<Response> handle(HandlerInput input, UserEvent userEvent) {

        String speechText = "ボタン操作をありがとうございます。 もうお気づきかと思いますが、テキストが消えました。「最初から始めて」と命令すると再び表示されます。";
        
        return input.getResponseBuilder()
            .withSpeech(speechText)
            .withReprompt("テキストを再び表示するには、「最初から始めて」と言います。または、もう一度「こんにちは」と言ってください。")
            .build();
    }
    
}

package handlers;

import static com.amazon.ask.request.Predicates.intentName;
import static util.Constants.HELLO_WORLD_WITH_BUTTON_TOKEN; // String "helloworldWithButtonToken"

import java.util.Optional;

import com.amazon.ask.dispatcher.request.handler.HandlerInput;
import com.amazon.ask.dispatcher.request.handler.RequestHandler;
import com.amazon.ask.model.Response;
import com.amazon.ask.model.interfaces.alexa.presentation.apl.AnimateItemCommand;
import com.amazon.ask.model.interfaces.alexa.presentation.apl.AnimatedOpacityProperty;
import com.amazon.ask.model.interfaces.alexa.presentation.apl.ExecuteCommandsDirective;
import com.amazon.ask.request.RequestHelper;
import com.amazon.ask.response.ResponseBuilder;
import com.fasterxml.jackson.databind.JsonNode;

public class StartOverIntentHandler implements RequestHandler {
    @Override
    public boolean canHandle(HandlerInput input) {
        return input.matches(intentName("AMAZON.StartOverIntent"));
    }

    @Override
    public Optional<Response> handle(HandlerInput input) {
        String speechText;
        ResponseBuilder responseBuilder = input.getResponseBuilder();        
        
        if (RequestHelper.forHandlerInput(input)
            .getSupportedInterfaces()
            .getAlexaPresentationAPL() != null) {
            // JSONリクエストのAPL視覚コンテンツ情報を取得します。
            // 現在表示されているドキュメントのIDが
            // HELLO_WORLD_WITH_BUTTON_TOKENトークン（"helloworldWithButtonToken"）
            // であることを確認します。
            JsonNode context = input.getRequestEnvelopeJson().get("context");
            if (context.has("Alexa.Presentation.APL") && 
                (context.get("Alexa.Presentation.APL")
                    .get("token")
                    .asText()
                    .equals(HELLO_WORLD_WITH_BUTTON_TOKEN))){

                speechText = "では、テキストを再び表示してみましょう。";

                AnimatedOpacityProperty animatedOpacityProperty = AnimatedOpacityProperty.builder()
                    .withTo(1.0)
                    .build();
    
                AnimateItemCommand animateItemCommand = AnimateItemCommand.builder()
                    .withComponentId("helloTextComponent")
                    .withDuration(3000)
                    .addValueItem(animatedOpacityProperty)
                    .build();

                    // ExecuteCommandsのトークンが
                    // もともとドキュメントを表示していたRenderDocumentディレクティブに
                    // 指定されているトークンと一致することが必要です
                    ExecuteCommandsDirective executeCommandsDirective = ExecuteCommandsDirective.builder()
                        .withToken(HELLO_WORLD_WITH_BUTTON_TOKEN)
                        .addCommandsItem(animateItemCommand)
                        .build();
                
                    responseBuilder.addDirective(executeCommandsDirective);
            } else {
                // デバイスが想定したドキュメントを表示していないため、
                // 状況に応じた出力音声を用意します。
                speechText = "おや、リセット対象が何もありません。「ボタンインテントを使用するハローワールド」を呼び出してからボタンを押して、動作を確認してください。";
            }
            
        } else {
            speechText = "こんにちは。このサンプルは画面付きデバイスを使うと、もっと面白いことが起こります。Echo Show、Echo Spot、Fire TVのいずれかのデバイスで試してください。";
        }
     
        return responseBuilder
                .withSpeech(speechText)
                .build();
    }
}