本文介紹在語音服務(wù)對(duì)接中所要用到的技能,包含基本概念、如何創(chuàng)建與管理等。

概述

在生活物聯(lián)網(wǎng)平臺(tái)的自有品牌項(xiàng)目中的產(chǎn)品要使用不同語音平臺(tái)的語音控制時(shí),需要通過技能進(jìn)行賬號(hào)打通及配置轉(zhuǎn)換協(xié)議,來確保設(shè)備可以跨平臺(tái)語音控制。在云智能App和自有品牌App下所使用的技能不同,區(qū)別如下:

  • 云智能App公版技能

    云智能App公版技能有兩個(gè),技能名稱分別為Cloud Intelligence(云智能公版Alexa技能)Cloud Intelligence(云智能公版GoogleHome技能)

    公版技能

    當(dāng)您使用的App為云智能App時(shí),可以直接使用上述兩個(gè)云智能公版技能,無需進(jìn)行創(chuàng)建技能等步驟,可對(duì)技能重新編輯配置OAuth授權(quán)信息技能信息。

    說明 使用云智能公版技能前提必須是使用云智能App,云智能App的計(jì)費(fèi)詳情請(qǐng)參見云智能App模板計(jì)費(fèi)

    注意,云智能App公版技能名稱不可更改,并且在第三方語音平臺(tái)中透出名稱也是云智能公版技能名稱,如果需要使用自有品牌專有的技能,可創(chuàng)建自有品牌App定制技能。

  • 自有品牌App定制技能

    自有品牌App的專有定制技能需要ISV自主創(chuàng)建及編輯等操作,詳細(xì)步驟請(qǐng)參考下文創(chuàng)建技能

創(chuàng)建技能

  1. 登錄生活物聯(lián)網(wǎng)控制臺(tái),在主頁面左側(cè)導(dǎo)航欄選擇運(yùn)維中心 > 語音服務(wù)進(jìn)入語音服務(wù)管理頁面。
  2. 技能列表頁,單擊創(chuàng)建技能進(jìn)入創(chuàng)建技能頁面。創(chuàng)建技能
  3. 填寫技能的基本信息后,單擊下一步

    技能的基本信息說明與示例如下方圖表所示:

    名詞 說明 示例
    技能名稱 技能在生活物聯(lián)網(wǎng)平臺(tái)的名稱,填寫輸入創(chuàng)建技能的名稱。 test
    語音平臺(tái) 技能接入的語音平臺(tái),可通過下拉選擇。 谷歌
    配置的項(xiàng)目 技能需要配置在項(xiàng)目下,用于將技能綁定該項(xiàng)目下的產(chǎn)品,可通過下拉選擇。 測(cè)試項(xiàng)目
    技能綁定的App 技能需要關(guān)聯(lián)的App,通過下拉選擇待綁定的App。
    說明 僅支持關(guān)聯(lián)在自有品牌項(xiàng)目下創(chuàng)建的自有App,云智能App可直接使用云智能公版技能。
    自有App
    配置
  4. 單擊去平臺(tái)配置前往第三方語音平臺(tái)進(jìn)行技能配置、驗(yàn)證和發(fā)布等操作,在第三方語音平臺(tái)完成配置后將信息同步填寫到控制臺(tái)的配置欄內(nèi),需確認(rèn)填寫的配置信息無誤后,可單擊下一步
    說明 在生活物聯(lián)網(wǎng)平臺(tái)中創(chuàng)建的技能主要是用于打通與第三方語音平臺(tái)的賬號(hào),根據(jù)上面步驟中選擇的語音平臺(tái),單擊去平臺(tái)配置主要是在第三方語音平臺(tái)下完成技能的配置、驗(yàn)證和發(fā)布,關(guān)于在第三方語音平臺(tái)的詳細(xì)操作請(qǐng)參考以下:
    • 當(dāng)您選擇接入Amazon Alexa語音平臺(tái),可根據(jù)下方圖表填寫技能信息進(jìn)行綁定。OAuth回調(diào)地址
      名詞 說明 示例
      OAuth授權(quán)設(shè)置 回調(diào)通過OAuth授權(quán)方式,請(qǐng)?zhí)顚懩鷦?chuàng)建的Alexa Skill的AccountLinking中的3個(gè)Redirect URLs。 https://layla.amazon.com/api/skill/link/MB****CTIMCLT
      appToAppRedirectUrls 對(duì)應(yīng)Alexa技能AccountLinking頁面上Yours Redirect URLs配置項(xiàng)。 https://pitangui.amazon.com/api/skill/link/MB****CTIMCLT
      客服聯(lián)系郵箱 會(huì)展示在Alexa技能賬號(hào)綁定在幫助頁面上,請(qǐng)?zhí)顚懧?lián)系郵箱。 a***@example.net
      Alexa Client Id 在Alexa技能控制臺(tái)中Permission頁面上,Alexa平臺(tái)生成的Client Id。 amzn1.application-oa2-client.40****1c6a354fefa851e1d36c9e4cd6
      Alexa Client Secret 在Alexa技能控制臺(tái)中Permission頁面上,Alexa平臺(tái)生成的Client Secret。 f666310a23651d4852dd6870b3ba54d29e815f05e659a4ee85058483****63b6
      Alexa Skill Id 在Alexa技能控制臺(tái)界面創(chuàng)建技能的生成的skillid。 amzn1.ask.skill.3be38fae-e2a1-4825-8291-4b28****b959
    • 當(dāng)您選擇接入Google Home語音平臺(tái),可根據(jù)下方圖表填寫技能信息進(jìn)行綁定。Project ID
      名詞 說明 示例
      OAuth授權(quán)設(shè)置 回調(diào)通過OAuth授權(quán)方式,請(qǐng)?zhí)顚懩鷦?chuàng)建的Google Action的Project ID。 111111111****1
      推送代理賬號(hào)設(shè)置 在Google創(chuàng)建的開發(fā)項(xiàng)目下的服務(wù)賬號(hào),平臺(tái)將代理該服務(wù)賬號(hào)身份進(jìn)行Google HomeGraph信息同步,請(qǐng)?zhí)顚懛?wù)賬號(hào)。 user****@example.com
      客服聯(lián)系郵箱 會(huì)展示在Google技能賬號(hào)綁定在幫助頁面上,請(qǐng)?zhí)顚懧?lián)系郵箱。 a***@example.net
  5. 購買并開通語音服務(wù)。

    如未開通技能定制開發(fā)服務(wù),可單擊去購買前往在彈出的購買頁面購買開通相應(yīng)的技能定制開發(fā)服務(wù),技能定制服務(wù)的費(fèi)用詳情請(qǐng)參考服務(wù)計(jì)費(fèi)

    注意 此處需要購買開通的服務(wù)為技能定制語音服務(wù),技能定制服務(wù)的費(fèi)用是按次收費(fèi),購買渠道僅在本流程下可購買技能定制服務(wù)。
    去購買

    確認(rèn)購買語音服務(wù)的規(guī)格,單擊確認(rèn)購買開通三方語音服務(wù)。

    技能定制語音服務(wù)的規(guī)格及費(fèi)用分別為:

    • Google home skill 定制購買服務(wù)
    • Amazon alexa skill 定制Alexa
    說明 購買成功后返回創(chuàng)建技能頁面,可以單擊刷新更新服務(wù)開通狀態(tài)。
  6. 體驗(yàn)與發(fā)布

    完成以上步驟,需要下載已配置技能的自有App并登錄,在自有App中進(jìn)行綁定技能。

  7. 單擊完成即可成功在生活物聯(lián)網(wǎng)平臺(tái)上的創(chuàng)建技能。

管理技能

完成以上創(chuàng)建技能的步驟并發(fā)布技能后,可以在技能列表首頁,可以進(jìn)入技能管理頁面查看和編輯技能的配置信息,并管理該技能綁定的產(chǎn)品。

  1. 技能列表中,選擇需要管理的已發(fā)布技能,單擊管理前往技能管理頁面。技能管理
  2. 在技能管理頁面內(nèi)查看已發(fā)布的技能基礎(chǔ)信息,也可以單擊編輯進(jìn)行重新編輯OAuth授權(quán)信息。編輯
  3. 對(duì)于需要新增綁定到該技能下的產(chǎn)品,可以在技能管理頁下單擊綁定產(chǎn)品選擇并配置綁定產(chǎn)品的信息定,詳情請(qǐng)參考產(chǎn)品管理
  4. 針對(duì)已綁定的產(chǎn)品可單擊管理對(duì)產(chǎn)品進(jìn)行信息編輯等相關(guān)操作。