視覚応答とオーディオ応答を統合する

const HelloWorldRenderExampleHandler = {
    canHandle(handlerInput) {
        return Alexa.getRequestType(handlerInput.requestEnvelope) === 'IntentRequest'
            && Alexa.getIntentName(handlerInput.requestEnvelope) === 'HelloWorldRenderExample';
    },
    handle(handlerInput) {
        let responseBuilder = handlerInput.responseBuilder;

        let speakOutput = "ハローワールド。 これはoutputSpeechです。Alexaは、"
            + "APL for Audioドキュメントをレンダリングする前にこのテキストを読み上げます。";

        let welcomeTextToSpeak = "";
        let speechContentType = "SSML";

        if (supportsAPL(handlerInput)) {

            // RenderDocumentディレクティブをresponseBuilderに追加します。この
            // サンプルでは、APLドキュメントはオーサリングツールで
            // 「helloWorldRenderExample」という名前で保存されているものとします。

            // 実際のスキルでは、APIから取得したデータやユーザーから
            // 収集した情報など、その他の情報に基づいてデータソースを
            // 動的に生成します。

            responseBuilder.addDirective({
                type: 'Alexa.Presentation.APL.RenderDocument',
                token: "HelloWorldRenderExampleToken",
                document: {
                    src: 'doc://alexa/apl/documents/helloWorldRenderExample',
                    type: 'Link'
                },
                datasources: {
                    helloWorldData: {
                        properties: {
                            headerTitle: "サンプル： オーディオ応答と視覚応答を同時に送信する",
                            primaryText: {
                                type: "PlainText",
                                text: "APLへようこそ"
                            },
                            secondaryText: {
                                type: "PlainText",
                                text: "このサンプルでは、2つのディレクティブを同時に送信します。"
                            }
                        }
                    }
                }
            });

            // APL for Audioドキュメントに渡す読み上げ音声を定義します。

            welcomeTextToSpeak =
                "<speak><amazon:emotion name='excited' intensity='medium'>APLへようこそ。</amazon:emotion>"
                + "このサンプルでは、2つのディレクティブを同時に送信します。1つの応答で"
                + "APL RenderDocumentディレクティブとA.P.L.A RenderDocumentディレクティブの両方を送信すると、"
                + "これらのディレクティブによって、オーディオ応答と視覚応答が同時に呼び出されます。"
                + "オーディオ応答は通常のoutputSpeechの読み上げ後に再生されるため、outputSpeech"
                + "とAPL for Audio応答が重なることはありません。</speak>";

        } else {
            // ユーザーのデバイスがAPLに対応していません。画面なしのデバイスに合わせて
            // APL for Audioドキュメントに渡す読み上げ音声を定義します。
            welcomeTextToSpeak = "このデバイスはAPLに対応していませんが、APL for Audio応答のレンダリングは行えます。"
                + "このサンプルは、Echo ShowやFire TVなどの画面付きデバイスでお試しください。";
            speechContentType = "PlainText"
        }

        // APLA RenderDocumentディレクティブを応答に追加します。このサンプルでは、
        // APL for Audioドキュメントはオーサリングツールで
        // 「helloWorldRenderExampleAudio」という名前で保存されているものとします。

        // このサンプルでは、データソースのtextToSpeakプロパティに
        // 先ほど保存した読み上げ音声を設定します。

        responseBuilder.addDirective({
            type: 'Alexa.Presentation.APLA.RenderDocument',
            document: {
                src: 'doc://alexa/apla/documents/helloWorldRenderExampleAudio',
                type: 'Link'
            },
            datasources: {
                helloWorldData: {
                    welcomeText: {
                        contentType: speechContentType,
                        textToSpeak: welcomeTextToSpeak
                    }
                }
            }
        });

        // 応答を送信します。
        return responseBuilder
            .speak(speakOutput)
            .getResponse();
    }
};

const HelloWorldEmbedAPLAudioExampleHandler = {
    canHandle(handlerInput) {
        return Alexa.getRequestType(handlerInput.requestEnvelope) === 'IntentRequest'
            && Alexa.getIntentName(handlerInput.requestEnvelope) === 'HelloWorldEmbedAPLAudioExample';
    },
    handle(handlerInput) {
        let responseBuilder = handlerInput.responseBuilder;

        if (supportsAPL(handlerInput)) {

            // RenderDocumentディレクティブをresponseBuilderに追加します。この
            // サンプルでは、APLドキュメントはオーサリングツールで
            // 「helloWorldEmbedAPLAudioExample」という名前で保存されているものとします。
            
            // このコードでは、aplAudioToSpeechトランスフォーマーによって
            // 参照されるAPL for Audioドキュメントへのリンクを含む
            // ディレクティブのsourcesプロパティも更新されます。
            
            responseBuilder.addDirective({
                type: 'Alexa.Presentation.APL.RenderDocument',
                token: "HelloWorldEmbedAPLAudioExample",
                document: {
                    src: 'doc://alexa/apl/documents/helloWorldEmbedAPLAudioExample',
                    type: 'Link'
                },
                datasources: {
                    helloWorldData: {
                        type: "object",
                        objectId: "helloWorldSample",
                        properties: {
                            headerTitle: "サンプル： 視覚応答からオーディオ応答を呼び出す",
                            primaryText: {
                                type: "PlainText",
                                text: "APLへようこそ（オーディオ応答付き）"
                            },
                            secondaryText: {
                                type: "PlainText",
                                text: "このサンプルでは、APLドキュメントにAPL for Audio応答を埋め込みます。"
                            },
                        welcomeText: {
                            contentType: "SSML",
                            textToSpeak: "<speak><amazon:emotion name='excited' intensity='medium'>APLへようこそ。</amazon:emotion> "
                                        + "このサンプルでは、APL for Audio応答をAPLドキュメントに統合します。"
                                        + "これには、まずAPLオーディオを音声に変換するトランスフォーマーを使用して、オーディオクリップを作成します。"
                                        + "次に、トランスフォーマーの出力をAPLドキュメント内のコンポーネントのspeechプロパティに"
                                        + "バインドします。最後に、SpeakItemコマンドを使用してオーディオを呼び出します。"
                                        + "このサンプルでは、onMountハンドラーからコマンドを実行するため、ドキュメントが表示されたときに"
                                        + "コマンドが実行されます。</speak>"
                        }
                    },
                        transformers: [
                            {
                                template: "helloWorldEmbedAPLAudioExampleAudio",
                                transformer: "aplAudioToSpeech",
                                outputName: "welcomeSpeech"
                            }
                        ]
                    }
                },
                sources: {
                    "helloWorldEmbedAPLAudioExampleAudio": {
                        src: 'doc://alexa/apla/documents/helloWorldEmbedAPLAudioExampleAudio',
                        type: 'Link'
                    }   
                }
            });
            
        } else {
            // ユーザーのデバイスがAPLに対応していません。オーディオのみの応答用の
            // RenderDocumentディレクティブを作成します。 このサンプルでは、
            // APL for Audioドキュメントはオーサリングツールで
            // 「helloWorldEmbedAPLAudioExampleAudio」という名前で保存されているものとします。
            
            responseBuilder.addDirective({
                type: 'Alexa.Presentation.APLA.RenderDocument',
                document: {
                    src: 'doc://alexa/apla/documents/helloWorldEmbedAPLAudioExampleAudio',
                    type: 'Link'
                },
                datasources: {
                    helloWorldData: {
                        welcomeText: {
                            contentType: "PlainText",
                            textToSpeak: "このデバイスはAPLに対応していませんが、APL for Audio応答のレンダリングは行えます。"
                                          + "このサンプルは、Echo ShowやFire TVなどの画面付きデバイスでお試しください。"
                        }
                    }
                }
            });
            
        }

        // 応答を送信します。応答には「outputSpeech」プロパティは含まれません。
        // 画面付きデバイスの場合は、ドキュメントが表示されたときに、ドキュメントから
        // オーディオが呼び出されます。画面のないデバイスの場合は、RenderDocumentディレクティブから、
        // APL for Audioドキュメントによって生成された音声が呼び出されます。
        return responseBuilder
            .getResponse();
    }

};

const SelectListItemHandler = {
    canHandle(handlerInput) {
        // AMAZON.SelectIntentに対してこのハンドラーをトリガーするのは、
        // 項目のリストを含むドキュメントがデバイスに現在表示されている場合のみです。
        // この場合、リクエストのコンテキスト内のトークンは、ドキュメントを表示した
        // RenderDocumentで使用されているトークンと一致します。
        const context = handlerInput.requestEnvelope.context;
        let token = "";
        if (context["Alexa.Presentation.APL"]){
            token = context["Alexa.Presentation.APL"].token
        }
        
        return Alexa.getRequestType(handlerInput.requestEnvelope) === 'IntentRequest'
            && Alexa.getIntentName(handlerInput.requestEnvelope) === 'AMAZON.SelectIntent'
            && token === 'SpeakListAPLForAudioExample';
    },
    handle(handlerInput) {
        
        let speakOutput = "";
        let itemToSpeakId = "";
        let responseBuilder = handlerInput.responseBuilder;
        
        // スキルがこのハンドラーを呼び出すのはドキュメントが画面に表示されている場合のみであるため、
        // デバイスがAPLに対応しているかどうかを確認する必要はありません。
        
        // ユーザーは、リスト項目の1つを選択するようリクエストしています。その項目が画面に表示されている場合は、
        // 項目のIDがListPositionスロットのresolutionsに格納されます。項目が
        // 表示されていない場合は、ListPositionスロットの値から、ユーザーがリクエストした番号を
        // 取得できます。
        
        const listPositionSlot = handlerInput
            .requestEnvelope
            .request
            .intent
            .slots
            .ListPosition;
        
        const listPositionSlotValue = listPositionSlot.value;
        
        if (listPositionSlotValue) {
            // ListPositionスロットに値が格納されています。IDも格納されている場合は、ユーザーが
            // リクエストした項目が画面に表示されています。IDが格納されていない場合は、ユーザーが
            // 画面に表示されていない項目をリクエストしたか、発話に数値以外のものが
            // 含まれていた可能性があります。
            
            const listPositionSlotResolutionStatus = listPositionSlot
                .resolutions
                .resolutionsPerAuthority[0].status.code;    
            
            if (listPositionSlotResolutionStatus === "ER_SUCCESS_MATCH"){
            // resolutionsからIDを取得します。
            
                itemToSpeakId = handlerInput
                    .requestEnvelope
                    .request
                    .intent
                    .slots
                    .ListPosition
                    .resolutions
                    .resolutionsPerAuthority[0].values[0].value.id;
                    
                speakOutput = "わかりました。<say-as interpret-as='ordinal'>" 
                    + listPositionSlotValue 
                    + "</say-as>のサンプルサウンドを再生します。";
            
            } else {
                // ユーザーが画面に表示されていない項目をリクエストした可能性があるため、
                // 視覚コンテキストの解決を取得できませんでした。この場合、ListPositionスロットの値には
                // ユーザーがリクエストした番号が含まれているため、リスト内の項目が指定されているかどうかを
                // 確認できます。
                
                
                if (parseInt(listPositionSlotValue) <= TOTAL_LIST_ITEMS) {
                    itemToSpeakId = "soundItem_" + listPositionSlotValue;
                    speakOutput = "わかりました。<say-as interpret-as='ordinal'>" 
                        + listPositionSlotValue 
                        + "</say-as>のサンプルサウンドを再生します。リストをスクロールしてこの項目を表示します。";
                } else {
                    // ユーザーがリスト内にない項目をリクエストしています。
                    speakOutput = "すみません。サンプルサウンドのリストに<say-as interpret-as='ordinal'>" 
                        + listPositionSlotValue 
                        + "</say-as>の項目はありません。リストに表示されている項目をリクエストするか、画面上で項目をタップしてください。";
                }
    
            }
            
        } else {
            // ListPositionに値が格納されていないため、応答できないリクエストが
            // 行われています。
            speakOutput = "すみません。よくわかりません。リストに表示されている項目をリクエストするか、画面上で項目をタップしてください。";
        }

        // ExecuteCommandsディレクティブを使用して、応答を作成して返します。このディレクティブには、
        // 画面上のドキュメントのRenderDocumentで使用されているトークンと一致するトークンを
        // 含める必要があります。
        
        responseBuilder.addDirective({
            type: 'Alexa.Presentation.APL.ExecuteCommands',
            token: "SpeakListAPLForAudioExample",
            commands: [
                {
                    "type": "SpeakItem",
                    "componentId": itemToSpeakId
                }
            ]
        });

        // 応答を返します。AlexaはoutputSpeechを再生してから、ディレクティブで指定された
        // コマンドを実行します。
        return responseBuilder
            .speak(speakOutput)
            .getResponse();
    }

};