スキルマニフェストの例



スキルマニフェストの例

スキルマニフェストはスキルをJSONで表したものであり、スキルに必要なすべてのメタデータをAlexaに提供します。対話モデルとアカウントリンクのスキーマが使われる場合、マニフェストとは別に提供されます。詳細については、スキルマニフェストのスキーマを参照してください。

以下は、スキルマニフェストの例です。各スキルタイプについて、プライバシーとコンプライアンスの要件を考慮するようにしてください。

コネクテッドカースキルマニフェスト

以下は、コネクテッドカースキルのスキルマニフェストの例です。詳細については、Alexaのコネクテッドカースキルを参照してください。

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

{
  "vendorId": "<vendor id>",
  "manifest": {
    "publishingInformation": {
      "locales": {
        "ja-JP": {
          "summary": "これは、プロバイダー向けの車のリモコンAlexaスキルのサンプルです。",
          "examplePhrases": [
            "アレクサ、車のエンジンをかけて",
            "アレクサ、車内の温度を30度に設定して"
          ],
          "keywords": [
            "車のリモコン",
            "RCSK",
            "RCSKスキル",
            "車のリモコンスキル"
          ],
          "name": "車のリモコンスキルキット",
          "description": "このスキルには、車を制御するための基本機能と高度な機能があります。"
        }
      },
      "isAvailableWorldwide": false,
      "testingInstructions": "1)「アレクサ、車のエンジンをかけて」と言ってください。2)「アレクサ、車のヒーターをオンにして」と言ってください。",
      "category": "CONNECTED_CAR",
      "distributionCountries": ["JP"]
    },
    "apis": {
      "smartHome": {
        "endpoint": {
          "uri": "arn:aws:lambda:us-east-1:452493640596:function:sampleSkill"
        },
        "regions": {
          "NA": {
            "endpoint": {
              "uri": "arn:aws:lambda:us-east-1:452493640596:function:sampleSkill"
            }
          }
        },
        "supportedControls": {
          "type": "REMOTE_VEHICLE_CONTROL"
        }
      }
    },
    "manifestVersion": "1.0",
    "permissions": [
      {
        "name": "alexa::devices:all:address:full:read"
      }
    ],
    "privacyAndCompliance": {
      "allowsPurchases": false,
      "containsAds": false,
      "isChildDirected": false,
      "isExportCompliant": false,
      "usesPersonalInfo": false,
      "locales": {
        "ja-JP": {
          "termsOfUseUrl": "http://www.termsofuse.sampleskill.com",
          "privacyPolicyUrl": "http://www.myprivacypolicy.sampleskill.com"
        }
      }
    }
  }
}

カスタムスキルマニフェスト

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

{
  "manifest": {
    "publishingInformation": {
      "locales": {
        "ja-JP": {
          "summary": "これはAlexaカスタムスキルのサンプルです。",
          "examplePhrases": [
            "アレクサ、サンプルのカスタムスキルを開いて。",
            "アレクサ、サンプルのカスタムスキルを再生して。"
          ],
          "keywords": [
            "説明_フェーズ_1",
            "説明_フェーズ_2",
            "説明_フェーズ_3"
          ],
          "smallIconUri": "https://smallUri.com",
          "largeIconUri": "https://largeUri.com",
          "name": "サンプルのカスタムスキル名です。",
          "description": "このスキルの内容はおもしろいです。"
        }
      },
      "isAvailableWorldwide": false,
      "testingInstructions": "1) 'アレクサ、こんにちは'と言って",
      "category": "HEALTH_AND_FITNESS",
      "distributionCountries": [
        "US",
        "GB",
        "JP"
      ]
    },
    "apis": {
      "custom": {
        "endpoint": {
          "uri": "arn:aws:lambda:us-east-1:040623927470:function:sampleSkill"
        },
        "interfaces": [
          {
            "type":"ALEXA_PRESENTATION_APL"
          },		
          {
            "type":"AUDIO_PLAYER"
          },
          {
            "type":"CAN_FULFILL_INTENT_REQUEST"
          },
          {
            "type":"GADGET_CONTROLLER"
          },
          {
            "type":"GAME_ENGINE"
          },
          {
            "type":"RENDER_TEMPLATE"
          },
          {
            "type":"VIDEO_APP"
          }		  
        ],
        "regions": {
          "NA": {
            "endpoint": {
              "sslCertificateType": "Trusted",
              "uri": "https://customapi.sampleskill.com"
            }
          }
        }
      }
    },
    "manifestVersion": "1.0",
    "permissions": [
      {
        "name": "alexa::devices:all:address:full:read"
      },
      {
        "name": "alexa:devices:all:address:country_and_postal_code:read"
      },
      {
        "name": "alexa::household:lists:read"
      },
      {
        "name": "alexa::household:lists:write"
      },
      {
        "name": "alexa::alerts:reminders:skill:readwrite"
      }
    ],
    "privacyAndCompliance": {
      "allowsPurchases": false,
      "usesPersonalInfo": false,
      "isChildDirected": false,
      "isExportCompliant": true,
      "containsAds": false,
      "locales": {
        "ja-JP": {
          "privacyPolicyUrl": "http://www.myprivacypolicy.sampleskill.com",
          "termsOfUseUrl": "http://www.termsofuse.sampleskill.com"
        }
      }
    },
    "events": {
      "endpoint": {
        "uri": "arn:aws:lambda:us-east-1:040623927470:function:sampleSkill"
      },
      "subscriptions": [
        {
          "eventName": "SKILL_ENABLED"
        },
        {
          "eventName": "SKILL_DISABLED"
        },
        {
          "eventName": "SKILL_PERMISSION_ACCEPTED"
        },
        {
          "eventName": "SKILL_PERMISSION_CHANGED"
        },
        {
          "eventName": "SKILL_ACCOUNT_LINKED"
        }
      ],
      "regions": {
        "NA": {
          "endpoint": {
            "uri": "arn:aws:lambda:us-east-1:040623927470:function:sampleSkill"
          }
        }
      }
    }
  }
}

フラッシュブリーフィングスキルマニフェスト

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

{
  "manifest": {
    "manifestVersion": "1.0",
    "publishingInformation": {
      "locales": {
        "ja-JP": {
          "name": "サンプルのスキル名です。",
          "summary": "これはAlexaスキルのサンプルです。",
          "description": "このスキルには、基本機能と高度な機能があります。",
          "smallIconUri": "https://smallUri.com",
          "largeIconUri": "https://largeUri.com",
          "examplePhrases": [],
          "keywords": [
            "フラッシュブリーフィング",
            "ニュース",
            "ハプニング"
          ]
        }
      },
      "distributionCountries": [
        "US",
        "GB",
        "JP"
      ],
      "isAvailableWorldwide": false,
      "testingInstructions": "1) 'アレクサ、こんにちは'と言って",
      "category": "HEALTH_AND_FITNESS"
    },
    "privacyAndCompliance": {
      "allowsPurchases": false,
      "usesPersonalInfo": false,
      "isChildDirected": false,
      "isExportCompliant": true,
	  "containsAds": false,
      "locales": {
        "en-US": {
          "privacyPolicyUrl": "http://www.myprivacypolicy.sampleskill.com",
          "termsOfUseUrl": "http://www.termsofuse.sampleskill.com"
        }
      }
    },
    "apis": {
      "flashBriefing": {
        "locales": {
          "ja-JP": {
            "customErrorMessage": "エラーメッセージ",
            "feeds": [
              {
                "name": "feed name",
                "isDefault": true,
                "vuiPreamble": "から",
                "updateFrequency": "HOURLY",
                "genre": "POLITICS",
                "imageUri": "https://fburi.com",
                "contentType": "TEXT",
                "url": "https://feeds.sampleskill.com/feedX"
              }
            ]
          }
        }
      }
    }
  }
}

リストスキルマニフェスト

以下は、カスタムコンポーネントのないリストスキルマニフェストの例です。

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

{
  "manifest": {
    "publishingInformation": {
      "locales": {
        "ja-JP": {
          "summary": "これはAlexaスキルのサンプルです。",
          "examplePhrases": [
            "アレクサ、サンプルスキルを開いて。",
            "アレクサ、サンプルスキルを再生して。"
          ],
          "keywords": [
            "説明_フェーズ_1",
            "説明_フェーズ_2",
            "説明_フェーズ_3"
          ],
          "smallIconUri": "https://smallUri.com",
          "largeIconUri": "https://largeUri.com",
          "name": "サンプルのスキル名です。",
          "description": "このスキルの内容はおもしろいです。"
        }
      },
      "isAvailableWorldwide": false,
      "testingInstructions": "1) 'アレクサ、こんにちは'と言って",
      "category": "HEALTH_AND_FITNESS",
      "distributionCountries": [
        "US",
        "GB",
        "JP"
      ]
    },
    "apis": {
      "householdList": {}
    },
    "manifestVersion": "1.0",
    "permissions": [
      {
        "name": "alexa::devices:all:address:full:read"
      },
      {
        "name": "alexa:devices:all:address:country_and_postal_code:read"
      },
      {
        "name": "alexa::household:lists:read"
      },
      {
        "name": "alexa::household:lists:write"
      }
    ],
    "privacyAndCompliance": {
      "allowsPurchases": false,
      "locales": {
        "ja-JP": {
          "termsOfUseUrl": "http://www.termsofuse.sampleskill.com",
          "privacyPolicyUrl": "http://www.myprivacypolicy.sampleskill.com"
        }
      },
      "isExportCompliant": true,
      "containsAds": false,
      "isChildDirected": false,
      "usesPersonalInfo": false
    },
    "events": {
      "endpoint": {
        "uri": "arn:aws:lambda:us-east-1:040623927470:function:sampleSkill"
      },
      "subscriptions": [
        {
          "eventName": "SKILL_ENABLED"
        },
        {
          "eventName": "SKILL_DISABLED"
        },
        {
          "eventName": "SKILL_PERMISSION_ACCEPTED"
        },
        {
          "eventName": "SKILL_PERMISSION_CHANGED"
        },
        {
          "eventName": "SKILL_ACCOUNT_LINKED"
        },
        {
          "eventName": "ITEMS_CREATED"
        },
        {
          "eventName": "ITEMS_UPDATED"
        },
        {
          "eventName": "ITEMS_DELETED"
        }
      ],
      "regions": {
        "NA": {
          "endpoint": {
            "uri": "arn:aws:lambda:us-east-1:040623927470:function:sampleSkill"
          }
        }
      }
    }
  }
}

会議スキルマニフェスト

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

{
  "manifest": {
    "apis": {
      "alexaForBusiness": {
        "regions": {
          "NA": {
            "endpoint": {
              "uri": "arn:aws:lambda:us-east-1:123456789:function:myFunctionName1"
            }
          }
        },
        "endpoint": {
          "uri": "arn:aws:lambda:us-east-1:123456789:function:myFunctionName1"
        },
        "interfaces": [
          {
            "namespace": "Alexa.Business.Reservation.Room",
            "version": "1.0",
            "requests": [
              {
                "name": "Search"
              },
              {
                "name": "Create"
              },
              {
                "name": "Update"
              }
            ]
          }
        ]
      }
    },
    "manifestVersion": "1.0",
    "privacyAndCompliance": {
      "locales": {
        "ja-JP": {
          "privacyPolicyUrl": "http://www.myprivacypolicy.sampleskill.com",
          "termsOfUseUrl": "http://www.termsofuse.sampleskill.com"
        }
      },
      "allowsPurchases": false,
      "usesPersonalInfo": false,
      "isChildDirected": false,
      "isExportCompliant": true,
      "containsAds": false
    },
    "publishingInformation": {
      "locales": {
        "ja-JP": {
          "name": "会議室予約スキル",
          "smallIconUri": "https://smallUri.example.com/small1.png",
          "largeIconUri": "https://largeUri.example.com/large1.png",
          "summary": "これはAlexaスキルのサンプルです。",
          "description": "このスキルでは、Alexa for Businessの予約機能を提供します。",
          "examplePhrases": [
            "アレクサ、この部屋を予約して",
            "アレクサ、明日の午後3時の部屋を探して"
          ],
          "keywords": [
            "会議",
            "予約",
            "Alexa For Business"
          ],
          "updatesDescription": "このスキルには、機能のバグを修正する更新があります。"
        }
      },
      "isAvailableWorldwide": false,
      "testingInstructions": "1)「アレクサ、この部屋を予約して」と言います",
      "category": "CALENDARS_AND_REMINDERS",
      "distributionCountries": [
        "JP"
      ]
    }
  }
}

スマートホームスキルマニフェスト

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

{
  "manifest": {
    "manifestVersion": "1.0",
    "publishingInformation": {
      "locales": {
        "ja-JP": {
          "name": "サンプルのスキル名です。",
          "summary": "これはAlexaスキルのサンプルです。",
          "description": ""このスキルには基本および高度なスマートデバイス管理機能を提供します。",
          "smallIconUri": "https://smallUri.com",
          "largeIconUri": "https://largeUri.com",
          "examplePhrases": [
            "アレクサ、サンプルスキルを開いて。",
            "アレクサ、キッチンのライトを点けて。"
          ],
          "keywords": [
            "スマートホーム",
            "ライト",
            "スマートデバイス"
          ]
        }
      },
      "distributionCountries": [
        "US",
        "GB",
        "JP"
      ],
      "isAvailableWorldwide": false,
      "testingInstructions": "1) 'アレクサ、サンプルのライトをオンにして'と言って",
      "category": "SMART_HOME"
    },
    "privacyAndCompliance": {
      "allowsPurchases": false,
      "usesPersonalInfo": false,
      "isChildDirected": false,
      "isExportCompliant": true,
      "containsAds": false,
      "locales": {
        "ja-JP": {
          "privacyPolicyUrl": "http://www.myprivacypolicy.sampleskill.com",
          "termsOfUseUrl": "http://www.termsofuse.sampleskill.com"
        }
      }
    },
    "apis": {
      "smartHome": {
        "endpoint": {
          "uri": "arn:aws:lambda:us-west-2:040623927470:function:sampleSkill"
        },
        "regions": {
          "FE": {
            "endpoint": {
              "uri": "arn:aws:lambda:us-west-2:010623927470:function:sampleSkillWest"
            }
          }
        }
      }
    }
  }
}

ビデオスキルマニフェスト

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

{
  "manifest": {
    "publishingInformation": {
      "locales": {
        "ja-JP": {
          "summary": "これはAlexaスキルのサンプルです。",
          "examplePhrases": [
            "アレクサ、206チャンネルに切り替えて",
            "アレクサ、コメディ映画を検索して",
            "アレクサ、一時停止して"
          ],
          "keywords": [
            "ビデオ",
            "テレビ"
          ],
          "name": "VideoSampleSkill",
          "smallIconUri": "https://smallUri.example.com",
          "largeIconUri": "https://smallUri.example.com",
          "description": "このスキルでは、ビデオ管理機能を提供しています。"
        }
      },
      "isAvailableWorldwide": false,
      "testingInstructions": "",
      "category": "SMART_HOME",
      "distributionCountries": [
        "US",
        "GB",
        "JP"
      ]
    },
    "apis": {
      "video": {
        "countries": {
          "US": {
            "catalogInformation": [
              {
                "type": "INGESTED_CONTENT_IDENTIFIER",
                "sourceId": "catalogName"
              },
              {
                "type": "LIVE_TV_MSO",
                "sourceId": "MSOId"
              }
            ]
          }
        },
        "locales": {
          "ja-JP": {
            "videoProviderTargetingNames": [
              "VideoSampleSkill",
              "TV provider"
            ],
            "features": [
              {
                "version": "1.0",
                "players": [
                  {
                    "logoImageUri": "https://logoImageUri.example.com",
                    "type": "AVS_3P_PROVIDED",
                    "uri": "https://webplayerUri.example.com/index.html",
                    "backgroundImageUri": "https://backgroundImageUri.example.com"
                  }
                ],
                "name": "VIDEO_WEB_PLAYER"
              }
            ]
          }
        },
        "endpoint": {
          "uri": "arn:aws:lambda:us-east-1:452493640596:function:sampleSkill"
        },
        "regions": {
          "NA": {
            "endpoint": {
              "uri": "arn:aws:lambda:us-east-1:452493640596:function:sampleSkill"
            }
          }
        },
        "protocolVersion": "3.0"
      }
    },
    "manifestVersion": "1.0",
    "privacyAndCompliance": {
      "allowsPurchases": false,
      "locales": {
        "ja-JP": {
          "termsOfUseUrl": "https://www.termsofuse.skill.example.com",
          "privacyPolicyUrl": "https://www.myprivacypolicy.skill.example.com"
        }
      },
      "isExportCompliant": true,
      "isChildDirected": false,
      "usesPersonalInfo": false,
      "containsAds": false
    }
  }
}