スマートホームスキルの作成手順

Note: Sign in to the developer console to build or publish your skill.

スマートホームスキルの作成手順

スマートホームスキルを作成するときは、Alexaがスキルを呼び出し、ユーザーのリクエストに対応してスマートホームデバイスを制御できるようにします。スマートホームスキルでは、プリビルドの音声対話モデルを使用します。発話セットはAlexaによって定義されます。Alexaスマートホームスキルは、ほとんどのデバイスタイプに対して作成できます。

スマートホームスキルの概要については、スマートホームスキルを理解するを参照してください。仮想電球を制御するスマートホームスキルを作成するステップバイステップのチュートリアルについては、チュートリアル：スマートホームスキルの作成を参照してください。

スマートホームスキルを作成するには、以下の手順を実行します。

前提条件

スマートホームスキルを開発する際に必要なものは以下のとおりです。

Amazon開発者アカウント。日本語のスキルを開発してテストするには、Amazon.co.jpのアカウントを使用します。作成済みでない場合は、Amazon.co.jpにアクセスして新しいアカウントを作成してください。アカウントは無料です。
アマゾンウェブサービス（AWS）アカウント。AWSアカウントを使用すると、サービスの無料利用枠の一部としてリソースにアクセスできます。スキルコードはAWS Lambdaでホストします。
デバイス制御クラウドに接続するスマートデバイス（照明、サーモスタット、カメラ、ロックなど）。スキルは、デバイスでサポートされている通信チャネルを使用して、デバイスまたはデバイス制御クラウドと通信します。
Alexa搭載デバイス（Amazon Echoなど）。Echoへのサインインには、Alexa開発者アカウントと同じ認証情報を使用してください。
モバイルデバイスにインストールしたAmazon Alexaアプリ。Alexaアプリのダウンロード手順については、AmazonウェブサイトのAlexaアプリをダウンロードするを参照してください。モバイルデバイス上のAlexaアプリへのサインインには、Alexa開発者アカウントと同じ認証情報を使用してください。
JSONと、AWS Lambdaスキルコードでサポートされるプログラミング言語（ Node.js、Java、Python、C#、Go、Ruby、PowerShellのいずれか）に関する知識。
アカウントリンクのためのOAuth 2.0プロバイダー。Amazon認可サーバーのLogin with Amazon（LWA）を使用するか、独自のOAuth 2.0プロバイダーを選択できます。
デバイスとやり取りし、ユーザーをデバイスに関連付けることができるデバイス制御クラウド。AWS IoT または独自のクラウドプロバイダーを使用できます。
スマートホームデバイスを制御するディレクティブを定義する、適切なスマートホームスキルAPI。スマートホームスキルAPIでサポートされるロケールと言語については、Alexaインターフェースとサポートしている言語の一覧を参照してください。
スキルの認定要件であるポリシーとセキュリティに関する知識。

スマートホームスキルの作成手順

スマートホームスキルを作成するには、次の手順を実行します。

スマートホームスキルを作成します。
スキルコードを実装します。
アカウントリンクを設定します。
スキルをテストします。
公開情報を追加します。
スキルのベータテスト（任意）を行います。
スキルの認定を申請します。

ステップ1：スマートホームスキルを作成する

スマートホームスキルは、Alexa開発者コンソールで作成します。スキルに追加するモデルは、スマートホームモデルを選択します。

デフォルトの言語とリージョンとして日本語（日本）を選択することも、ほかの言語とリージョンでスキルを作成することもできます。スキルを提供する予定のリージョンを選択してください。スキルは複数の言語で作成できます。詳細については、スマートホームスキルを複数の言語で開発するを参照してください。サポートされる言語はインターフェースによって異なります。詳細については、Alexaインターフェースとサポートされる言語の一覧を参照してください。

スキルを作成したら、スキルIDを参照しやすい場所にコピーしておきます。Windowsではメモ帳、Macではテキストエディットなどを使用できます。スキルIDは、Lambdaでホストされるスキルコードにスキルを接続するために必要になります。

注：スキルコードをLambda関数として実装したら、開発者コンソールに戻ってスマートホームのサービスエンドポイントを設定します。また、スキルコードを実装したら、戻ってアカウントリンクも設定します。

ステップ2：スキルコードを実装する

スマートホームスキルのコードは、アマゾンウェブサービス（AWS）のLambda関数として実装します。詳細については、スマートホームスキルのコードを実装するを参照してください。必要に応じて、スキルに追加機能を実装できます。

スキルコードの例

次のスマートホームスキルのコード例では、電球を制御しています。

Node.js
Python

クリップボードにコピーされました。

// -*- coding: utf-8 -*-

// Copyright 2021 Amazon.com, Inc. or its affiliates.All Rights Reserved.
//
// SPDX-License-Identifier: LicenseRef-.amazon.com.-AmznSL-1.0
// アマゾンソフトウェア使用許諾（以下「ライセンス」）で使用許諾されています。
// ライセンスに準拠することなくこのファイルを使用することはできません。
// ライセンスのコピーは、http://aws.amazon.com/asl/で参照できます。
//
// このファイルは「現状有姿」で配布され、
// 明示または黙示を問わず、いかなる種類の保証も条件もありません。ライセンスに基づく許可と制限を
// 規定する特定の言語については、ライセンスを参照してください。

exports.handler = function (request, context) {
    if (request.directive.header.namespace === 'Alexa.Discovery' && request.directive.header.name === 'Discover') {
        log("DEBUG:", "Discover request",  JSON.stringify(request));
        handleDiscovery(request, context, "");
    }
    else if (request.directive.header.namespace === 'Alexa.PowerController') {
        if (request.directive.header.name === 'TurnOn' || request.directive.header.name === 'TurnOff') {
            log("DEBUG:", "TurnOn or TurnOff Request", JSON.stringify(request));
            handlePowerControl(request, context);
        }
    }
    else if (request.directive.header.namespace === 'Alexa.Authorization' && request.directive.header.name === 'AcceptGrant') {
        handleAuthorization(request, context)
    }

    function handleAuthorization(request, context) {
        // AcceptGrant応答を送信します
        var payload = {};
        var header = request.directive.header;
        header.name = "AcceptGrant.Response";
        log("DEBUG", "AcceptGrant Response: ", JSON.stringify({ header: header, payload: payload }));
        context.succeed({ event: { header: header, payload: payload } });
    }

    function handleDiscovery(request, context) {
        // 検出応答を送信します
        var payload = {
            "endpoints":
            [
                {
                    "endpointId": "sample-bulb-01",
                    "manufacturerName": "スマートデバイス株式会社",
                    "friendlyName": "リビングの照明",
                    "description": "仮想スマート電球",
                    "displayCategories": ["LIGHT"],
                    "additionalAttributes":  {
                        "manufacturer" : "サンプルメーカー",
                        "model" : "サンプルモデル",
                        "serialNumber": "U11112233456",
                        "firmwareVersion" : "1.24.2546",
                        "softwareVersion": "1.036",
                        "customIdentifier": "サンプルカスタムID"
                    },
                    "cookie": {
                        "key1": "このエンドポイントを参照するためのスキルの任意のキー／値のペアです。",
                        "key2": "複数のエントリがある場合があります。",
                        "key3": "ただし、参照のためにだけ使用してください。",
                        "key4": "現在のエンドポイントの状態を維持するのに適切な場所ではありません。"
                    },
                    "capabilities":
                    [
                        {
                            "interface": "Alexa.PowerController",
                            "version": "3",
                            "type": "AlexaInterface",
                            "properties": {
                                "supported": [{
                                    "name": "powerState"
                                }],
                                 "retrievable": true
                            }
                        },
                        {
                        "type": "AlexaInterface",
                        "interface": "Alexa.EndpointHealth",
                        "version": "3.2",
                        "properties": {
                            "supported": [{
                                "name": "connectivity"
                            }],
                            "retrievable": true
                        }
                    },
                    {
                        "type": "AlexaInterface",
                        "interface": "Alexa",
                        "version": "3"
                    }
                    ]
                }
            ]
        };
        var header = request.directive.header;
        header.name = "Discover.Response";
        log("DEBUG", "Discovery Response: ", JSON.stringify({ header: header, payload: payload }));
        context.succeed({ event: { header: header, payload: payload } });
    }

    function log(message, message1, message2) {
        console.log(message + message1 + message2);
    }

    function handlePowerControl(request, context) {
        // 検出中に渡されたデバイスIDを取得します
        var requestMethod = request.directive.header.name;
        var responseHeader = request.directive.header;
        responseHeader.namespace = "Alexa";
        responseHeader.name = "Response";
        responseHeader.messageId = responseHeader.messageId + "-R";
        // リクエスト中のユーザートークンパスを取得します
        var requestToken = request.directive.endpoint.scope.token;
        var powerResult;

        if (requestMethod === "TurnOn") {

            // デバイス制御クラウドを呼び出して制御します
            // powerResult = stubControlFunctionToYourCloud(endpointId, token, request);
            powerResult = "ON";
        }
       else if (requestMethod === "TurnOff") {
            // デバイス制御クラウドを呼び出して制御し、成功したかどうか確認します
            // powerResult = stubControlFunctionToYourCloud(endpointId, token, request);
            powerResult = "OFF";
        }
        // 更新されたpowerStateを返します。 Alexa.Responseには必ずEndpointHealthを含めます。
        // timeOfSampleの日時形式はISO 8601で、YYYY-MM-DDThh:mm:ssZとなります。
        var contextResult = {
            "properties": [{
                "namespace": "Alexa.PowerController",
                "name": "powerState",
                "value": powerResult,
                "timeOfSample": "2022-09-03T16:20:50.52Z", //結果から取得します。
                "uncertaintyInMilliseconds": 50
            },
            {
                "namespace": "Alexa.EndpointHealth",
                "name": "connectivity",
                "value": {
                "value": "OK"
            },
            "timeOfSample": "2022-09-03T22:43:17.877738+00:00",
            "uncertaintyInMilliseconds": 0
            }]
        };
        var response = {
            context: contextResult,
            event: {
                header: responseHeader,
                endpoint: {
                    scope: {
                        type: "BearerToken",
                        token: requestToken
                    },
                    endpointId: "sample-bulb-01"
                },
                payload: {}
            }
        };
        log("DEBUG", "Alexa.PowerController ", JSON.stringify(response));
        context.succeed(response);
    }
};

クリップボードにコピーされました。

# -*- coding: utf-8 -*-

# Copyright 2021 Amazon.com, Inc. or its affiliates.All Rights Reserved.
#
# SPDX-License-Identifier: LicenseRef-.amazon.com.-AmznSL-1.0
# アマゾンソフトウェア使用許諾（以下「ライセンス」）で使用許諾されています。
# ライセンスに準拠することなく
# このファイルを使用することはできません。ライセンスのコピーは、http://aws.amazon.com/asl/で参照できます。
#
# このファイルは「現状有姿」で配布され、
# 明示または黙示を問わず、いかなる種類の保証も条件もありません。ライセンスに基づく許可と制限を
# 規定する特定の言語については、ライセンスを参照してください。


import json
import math
import random
import uuid
import logging
import datetime
from datetime import datetime, timezone

logger = logging.getLogger(__name__)
logger.setLevel(logging.INFO)

def lambda_handler(request, context):

    # リクエストをダンプしてログに記録します（CloudWatchログを確認してください）。
    print('lambda_handler request  -----')
    print(json.dumps(request))


    if context is not None:
        print('lambda_handler context  -----')
        print(context)

    # リクエストがAlexaスマートホームディレクティブであることを検証します。
    if 'directive' not in request:
        alexa_response = AlexaResponse(
            name='ErrorResponse',
            payload={'type': 'INVALID_DIRECTIVE',
                     'message': 'キーがありません：directive、リクエストは有効なAlexaディレクティブですか？'})
        return send_response(alexa_response.get())

    # ペイロードのバージョンを確認します。
    payload_version = request['directive']['header']['payloadVersion']
    if payload_version != '3':
        alexa_response = AlexaResponse(
            name='ErrorResponse',
            payload={'type': 'INTERNAL_ERROR',
                     'message': 'このスキルではスマートホームAPIのバージョン3のみがサポートされます'})
        return send_response(alexa_response.get())

    # リクエストを開いて確認します。
    name = request['directive']['header']['name']
    namespace = request['directive']['header']['namespace']

    # 名前空間に基づいてAlexaからの受信リクエストを処理します。
    if namespace == 'Alexa.Authorization':
        if name == 'AcceptGrant':
            # 注： このコード例では、すべてのGrantリクエストを受け入れます。
            # 実装では、Grantコードを使用してLogin with Amazonを呼び出し、アクセストークンと更新トークンを取得してください。
            grant_code = request['directive']['payload']['grant']['code']
            grantee_token = request['directive']['payload']['grantee']['token']
            auth_response = AlexaResponse(namespace='Alexa.Authorization', name='AcceptGrant.Response')
            return send_response(auth_response.get())

    if namespace == 'Alexa.Discovery':
        if name == 'Discover':
            # スキルが制御するデバイスを検出するためのリクエスト。
            discovery_response = AlexaResponse(namespace='Alexa.Discovery', name='Discover.Response')
            # 応答を作成し、電球の機能を追加します。
            capability_alexa = discovery_response.create_payload_endpoint_capability()
            capability_alexa_powercontroller = discovery_response.create_payload_endpoint_capability(
                interface='Alexa.PowerController',
                supported=[{'name': 'powerState'}])
            capability_alexa_endpointhealth = discovery_response.create_payload_endpoint_capability(
                interface='Alexa.EndpointHealth',
                supported=[{'name': 'connectivity'}])
            discovery_response.add_payload_endpoint(
                friendly_name='サンプル電球',
                endpoint_id='sample-bulb-01',
                capabilities=[capability_alexa, capability_alexa_endpointhealth, capability_alexa_powercontroller])
            return send_response(discovery_response.get())

    if namespace == 'Alexa.PowerController':
        # 電球をオンまたはオフにするためのディレクティブ。
        # 注： このコード例では、常に成功応答を返します。
        endpoint_id = request['directive']['endpoint']['endpointId']
        power_state_value = 'OFF' if name == 'TurnOff' else 'ON'
        correlation_token = request['directive']['header']['correlationToken']

        # 状態の設定時にエラーをチェックします。
        device_set = update_device_state(endpoint_id=endpoint_id, state='powerState', value=power_state_value)
        if not device_set:
            return AlexaResponse(
                name='ErrorResponse',
                payload={'type': 'ENDPOINT_UNREACHABLE', 'message': 'エンドポイントデータベースにアクセスできません。'}).get()

        directive_response = AlexaResponse(correlation_token=correlation_token)
        directive_response.add_context_property(namespace='Alexa.PowerController', name='powerState', value=power_state_value)
        return send_response(directive_response.get())

# 応答を送信します
def send_response(response):
    print('lambda_handler response -----')
    print(json.dumps(response))
    return response

# デバイス制御クラウドを呼び出して制御します
def update_device_state(endpoint_id, state, value):
    attribute_key = state + 'Value'
    # result = stubControlFunctionToYourCloud(endpointId, token, request);
    return True

# timeOfSampleの日時形式はISO 8601で、YYYY-MM-DDThh:mm:ssZとなります。
def get_utc_timestamp(seconds=None):
    return datetime.now(timezone.utc).isoformat()

class AlexaResponse:

    def __init__(self, **kwargs):

        self.context_properties = []
        self.payload_endpoints = []

        # 応答の構造を設定します。
        self.context = {}
        self.event = {
            'header': {
                'namespace': kwargs.get('namespace', 'Alexa'),
                'name': kwargs.get('name', 'Response'),
                'messageId': str(uuid.uuid4()),
                'payloadVersion': kwargs.get('payload_version', '3')
            },
            'endpoint': {
                "scope": {
                    "type": "BearerToken",
                    "token": kwargs.get('token', 'INVALID')
                },
                "endpointId": kwargs.get('endpoint_id', 'INVALID')
            },
            'payload': kwargs.get('payload', {})
        }

        if 'correlation_token' in kwargs:
            self.event['header']['correlation_token'] = kwargs.get('correlation_token', 'INVALID')

        if 'cookie' in kwargs:
            self.event['endpoint']['cookie'] = kwargs.get('cookie', '{}')

        # AcceptGrantリクエストまたはDiscoverリクエストにはendpointプロパティはありません。
        if self.event['header']['name'] == 'AcceptGrant.Response' or self.event['header']['name'] == 'Discover.Response':
            self.event.pop('endpoint')

    def add_context_property(self, **kwargs):
        self.context_properties.append(self.create_context_property(**kwargs))
        self.context_properties.append(self.create_context_property())


    def add_cookie(self, key, value):

        if "cookies" in self is None:
            self.cookies = {}

        self.cookies[key] = value

    def add_payload_endpoint(self, **kwargs):
        self.payload_endpoints.append(self.create_payload_endpoint(**kwargs))


    def create_context_property(self, **kwargs):
        return {
            'namespace': kwargs.get('namespace', 'Alexa.EndpointHealth'),
            'name': kwargs.get('name', 'connectivity'),
            'value': kwargs.get('value', {'value': 'OK'}),
            'timeOfSample': get_utc_timestamp(),
            'uncertaintyInMilliseconds': kwargs.get('uncertainty_in_milliseconds', 0)
        }

    def create_payload_endpoint(self, **kwargs):
        # エンドポイントで想定される適切な構造を返します。
        # すべての検出応答にはadditionAttributesを含める必要があります
        additionalAttributes = {
            'manufacturer': kwargs.get('manufacturer', 'サンプルメーカー'),
            'model': kwargs.get('model_name', 'サンプルモデル'),
            'serialNumber': kwargs.get('serial_number', 'U11112233456'),
            'firmwareVersion': kwargs.get('firmware_version', '1.24.2546'),
            'softwareVersion': kwargs.get('software_version', '1.036'),
            'customIdentifier': kwargs.get('custom_identifier', 'サンプルカスタムID')
        }

        endpoint = {
            'capabilities': kwargs.get('capabilities', []),
            'description': kwargs.get('description', 'スマートホームチュートリアル： 仮想スマート電球'),
            'displayCategories': kwargs.get('display_categories', ['LIGHT']),
            'endpointId': kwargs.get('endpoint_id', 'endpoint_' + "%0.6d" % random.randint(0, 999999)),
            'friendlyName': kwargs.get('friendly_name', 'サンプル照明'),
            'manufacturerName': kwargs.get('manufacturer_name', 'サンプルメーカー')
        }

        endpoint['additionalAttributes'] = kwargs.get('additionalAttributes', additionalAttributes)
        if 'cookie' in kwargs:
            endpoint['cookie'] = kwargs.get('cookie', {})

        return endpoint

    def create_payload_endpoint_capability(self, **kwargs):
        # すべての検出応答にはAlexaインターフェースを含める必要があります
        capability = {
            'type': kwargs.get('type', 'AlexaInterface'),
            'interface': kwargs.get('interface', 'Alexa'),
            'version': kwargs.get('version', '3')
        }
        supported = kwargs.get('supported', None)
        if supported:
            capability['properties'] = {}
            capability['properties']['supported'] = supported
            capability['properties']['proactivelyReported'] = kwargs.get('proactively_reported', False)
            capability['properties']['retrievable'] = kwargs.get('retrievable', False)
        return capability

    def get(self, remove_empty=True):

        response = {
            'context': self.context,
            'event': self.event
        }

        if len(self.context_properties) > 0:
            response['context']['properties'] = self.context_properties

        if len(self.payload_endpoints) > 0:
            response['event']['payload']['endpoints'] = self.payload_endpoints

        if remove_empty:
            if len(response['context']) < 1:
                response.pop('context')

        return response

    def set_payload(self, payload):
        self.event['payload'] = payload

    def set_payload_endpoint(self, payload_endpoints):
        self.payload_endpoints = payload_endpoints

    def set_payload_endpoints(self, payload_endpoints):
        if 'endpoints' not in self.event['payload']:
            self.event['payload']['endpoints'] = []

        self.event['payload']['endpoints'] = payload_endpoints

ステップ3：アカウントリンクを設定する

すべてのスマートホームスキルでは、アカウントリンクを有効にして、AlexaユーザーのIDをシステムのユーザーIDに関連付ける必要があります。たとえば、電球のシステムに、電球のモデルと機能（調光式かどうかなど）を格納するユーザーアカウントがあるとします。ユーザーがAlexaアプリでスキルを有効にすると、Alexaはアカウントリンクプロセスを開始し、システムからアクセストークンを受け取ります。その後、ユーザーがAlexaに電球を暗くするように指示すると、Alexaはスキルにアクセストークンを送信します。このトークンを使用することで、スキルはシステムのユーザーアカウントにアクセスして、電球が調光式かどうかを確認できます。

Alexaは、スマートホームスキルとビデオスキルにOAuth 2.0 Authorization code grant種別を使用します。アカウントリンクを設定するには、OAuthプロバイダーから以下の情報を取得する必要があります。これらのフィールドの詳細については、Authorization code grantを設定するを参照してください。

認可サーバーのログインページのURI - ユーザーがAlexaアプリでスキルを有効にすると、AlexaはこのURIにユーザーをリダイレクトして、ログイン認証情報の入力を求めます。ログインに成功すると、サーバーからAlexaに認可コードが返されます。
アクセストークンサーバーのURI - 認可コードをアクセストークンに交換できる、認可サーバーのエンドポイントです。
クライアントID - スキルを識別する一意の文字列です。スキルは、Alexaユーザーに代わってリソースサーバーにリクエストを送信します。
クライアントシークレット - Alexaは、クライアントIDとクライアントシークレットを使用して、アクセストークンURIで認証を行います。これらの認証情報によってAlexaからのリクエストが識別されます。
認証スキーム - Alexaがアクセストークンサーバーからアクセストークンと更新トークンをリクエストするために使用する、認証の種類を識別します。
スコープ - （オプション）ユーザーIDやパスワードなど、スキルユーザーに要求する認証情報のリストです。最大15個まで指定できます。
ドメイン - （オプション）認可サーバーがコンテンツをリクエストするドメインのリストです。最大30個まで指定できます。
デフォルトのアクセストークンの有効期限 - （オプション）サーバーがメッセージにアクセストークンの有効期限を指定しない場合は、アクセストークンの有効期間を示す秒数を提供する必要があります。

スキルの認可サーバーとセキュリティプロファイルの設定は、Alexa開発者コンソールで行います。スマートホームページで、左側のメニューからアカウントリンクをクリックします。必要な情報を入力し、保存をクリックします。Alexaのリダイレクト先のURLフィールドには、Alexaが使用するリダイレクト先のエンドポイントが表示されます。これらのリダイレクト先URLを認可サーバーに登録する必要があります。

Amazon OAuth認可サーバーのLogin with Amazon（LWA）を使用することも、独自のOAuth 2.0プロバイダーを使用することもできます。LWA認可サーバーとのアカウントリンクを設定する方法の詳細については、スマートホームチュートリアルのステップ4：アカウントリンクを設定するを参照してください。

ステップ4：スキルをテストする

スキルコードの開発中、Lambdaコンソールでテストケースを作成して、Alexaからのリクエストをテストできます。詳細については、スマートホームチュートリアル：ステップ2e： Lambda関数をテストするを参照してください。

注：テストをする前にLambdaコンソールの保存ボタンをクリックして最新のコードを反映します。

実装が完了したら、スキルを有効にしてテストを開始できます。

スキルを有効にしてテストを開始するには

Alexaアプリでスキルを有効にします。Alexaはアカウントリンクを実行し、スキルにAlexa.Authorization.AcceptGrantを送信して、スキルをユーザーのAmazonアカウントに接続します。次に、Alexa.Discoverリクエストをスキルに送信してデバイスを検出します。
スキルが正常にデバイスを検出したら、開発者コンソールでスキルをテスト用に有効にする手順を完了します。
開発者コンソールのテストタブで、Alexaシミュレーターを使用してスキルをテストします。
検出応答とAlexaアプリで確認できるフレンドリ名を使用して、Alexaにコマンドを伝えます。スキルがサポートしているデバイス機能に固有の発話を使用してください。また、有効な発話と無効な発話の両方でスキルをテストしてください。変更レポートとエンドポイントの正常性を確認するには、デバイスの電源をオフにしてからもう一度オンにします。
問題をデバッグするには、CloudWatchコンソールで、スキルのロググループにあるログを探します。

スキルコードを繰り返し実行し、テストを続けることができます。アカウントリンクの設定を変更する場合は、Alexaアプリでスキルを無効にしてから再度有効にして、変更後の設定をテストします。検出応答のコードを変更する場合も、Alexaアプリでスキルを無効にしてから再度有効にしてください。スキルのテストとデバッグのオプションについては、スマートホームスキルのデバッグを参照してください。

スキルが完成したら、スキルの公開情報を指定できます。

ステップ5：公開情報を追加する

スキルをAmazon Alexaスキルストアに公開するには、開発者コンソールの公開タブで、スキルに必要なメタデータを入力する必要があります。プライバシーポリシーと利用規約ページへのリンクを提供していること、およびクリック可能なすべてのリンクがiOS、Android、デスクトップデバイスで正常に開き、表示されることを確認してください。

スキル情報を入力して保存したら、スキルをベータテスト用に公開するか、認定の申請をすることができます。

ステップ6：スキルのベータテストを行う（任意）

必要に応じて、スキルのベータテストをセットアップできます。ベータテストでは一般公開はせず、個人的に選択した限定的なテストグループにスキルを公開します。詳細については、スキルのベータテストを参照してください。

ステップ7：スキルの認定を申請する

スキルの認定を申請する前に、スマートホームスキルおよびビデオスキルの認定ガイドを確認してください。

スキルを公開する準備が整ったら、認定の申請をします。スキルの認定の詳細については、Alexa開発者コンソールでスキルの認定を申請するを参照してください。

重要： 認定プロセス中は、スキルへの認定フィードバックを受け取るか認定が完了するまで、デバイスがオンラインになっていて検出可能であることが必要です。認定の失敗を防ぐために、デバイスは毎日24時間常時利用できる状態にしてください。

スキルの認定を申請するには

開発者コンソールの認定ページで、検証テストを実行します。これらのテストにより、スキルの認定を申請する前に修正する必要のある問題を特定できます。
スキルがAlexaのポリシーガイドラインを満たしていることを確認します。これらのガイドラインは、スキルがあらゆるユーザーに適していることを確認するために役立ちます。これらのガイドラインに従うことで、Alexaユーザーのプライバシーと公益を守ることができます。
スキルがAlexaのセキュリティ要件を満たしていることを確認します。ユーザーからの信頼は非常に重要です。ユーザーデータを保護するために、スキルはこれらのセキュリティ要件を満たしている必要があります。
スキルを公開する準備が整い、スキルがポリシーとセキュリティ要件を満たしていることが確認できたら、スキルの認定を申請します。

注：スキルの認定は、デバイスのWorks with Alexa（WWA）認定とは異なります。WWAは、製品とAlexaの互換性を確認し、製品パッケージにWWA認定バッジを付けることを許可する、別個の認定プログラムです。スキルの認定を取得したら、WWA認定を申請できます。詳細については、Works with Alexa認定の概要を参照してください。

スキルに追加機能を実装する

デバイスが在庫センサーをサポートしている場合は、スマートホームデバイスにAmazon Dash replenishmentサービスを追加して、Alexaでデバイスの消耗品や交換部品の監視と再注文を行うことができます。詳しくは、Dash Replenishmentについてを参照してください。

公開後にスキルの修正やアップデートを行う

Amazonでスキルがエンドユーザーに公開されると、スキルステータスが「公開中」になり、新しい「開発中」のバージョンが自動的に開発者コンソールに作成されます。このバージョンには、元の公開中のバージョンと同じ情報が登録されています。スキル設定やLambda関数に変更を加えた場合は、そのつど認定を受ける必要があります。更新したスキルを申請するときは、開発者コンソールのテストの手順に、すべての変更について詳細に説明した変更ログを追加します。詳細については、公開後にスキルの修正やアップデートを行うを参照してください。

Lambda関数に変更を加えるには

新しいLambda関数と新しいARNを作成します。
公開中のLambda関数のスキルコードを、新しいLambda関数にコピーします。
新しいLambda関数でスキルコードを更新します。
スキルの開発段階で、Lambda ARNの設定を更新して、新しいLambda関数のARNを指すようにします。その後、スキルの認定を申請します。

更新されたスキルがAmazonで認定されると、Alexaは新しいLambda ARNにリクエストを送信します。前のLambda関数は削除することも、将来の開発や更新のために使用することもできます。

このページは役に立ちましたか？

フィードバックを送信

最終更新日: 2024 年 12 月 20 日

スマートホームスキルの作成手順

前提条件

スマートホームスキルの作成手順

ステップ1： スマートホームスキルを作成する

ステップ2： スキルコードを実装する

スキルコードの例

ステップ3： アカウントリンクを設定する

ステップ4： スキルをテストする

ステップ5： 公開情報を追加する

ステップ6： スキルのベータテストを行う（任意）

ステップ7： スキルの認定を申請する

スキルに追加機能を実装する

公開後にスキルの修正やアップデートを行う

関連トピック

このページは役に立ちましたか？

ステップ1：スマートホームスキルを作成する

ステップ2：スキルコードを実装する

ステップ3：アカウントリンクを設定する

ステップ4：スキルをテストする

ステップ5：公開情報を追加する

ステップ6：スキルのベータテストを行う（任意）

ステップ7：スキルの認定を申請する