所以我們都準(zhǔn)備好了，只需使用我們最喜歡的（和免費(fèi)的）地圖服務(wù)的反向地理編碼功能，并解碼生成的 JSON 有效負(fù)載！但是，有一個(gè)問題！您會(huì)發(fā)現(xiàn)，這些服務(wù)中的大多數(shù)都不涵蓋主要水域，例如海洋！嘗試使用大西洋和太平洋等要素的坐標(biāo)，“未找到結(jié)果”是報(bào)告！我想這與將服務(wù)貨幣化有關(guān)。你真的找不到人去珊瑚海中央最近的星巴克！

幸運(yùn)的是，GeoNames.org提供了一個(gè) Web 服務(wù)，它確實(shí)在主要水域返回了有意義的有效載荷！我找不到另一個(gè)這樣做的免費(fèi)服務(wù)。如果你這樣做，請(qǐng)告訴我！

訪問 GeoNames.org 網(wǎng)站，申請(qǐng)用戶名/帳戶，每天最多可獲得 30,000 次訪問！請(qǐng)記住為您的用戶名/帳戶激活網(wǎng)絡(luò)服務(wù)！問題解決了。

寫作技巧

Mycroft 核心文檔包含一個(gè)關(guān)于創(chuàng)建技能的優(yōu)秀教程，并且在Mycroft github 頁面上有許多技能可供學(xué)習(xí)。我不會(huì)在這里重復(fù)該教程，但會(huì)指出我在創(chuàng)建此技能時(shí)使用的要點(diǎn)。

創(chuàng)建技能需要具有特定結(jié)構(gòu)的多個(gè)不同文件，并具有特定的文件名約定：

?

來自 Mycroft 的 github 頁面，可以使用一個(gè)空白技能模板。

?

/dialog文件夾包含基于語言的文件，這些文件告訴 Mycroft 在執(zhí)行技能時(shí)要說什么。這是來自 Mycroft.ai 的 github 存儲(chǔ)庫的Skill-hello-world/dialog/en-us/hello.world.dialog ：

Hello world
Hello
Hi to you too

在回應(yīng)你說“Hey Mycroft，Hello world”時(shí)，Mycroft 會(huì)從上面的 3 個(gè)回應(yīng)中選擇一個(gè)說出來。“Hey Mycroft”或只是“Mycroft”這些詞是指示 Mycroft 應(yīng)該開始聆聽的喚醒詞或觸發(fā)詞。

他怎么知道要聽什么才能執(zhí)行這項(xiàng)技能？這就是 /vocab 文件夾的來源。從教程中，

• “ vocab 文件夾包含支持的每種語言的子文件夾，例如 en-us。在每個(gè)語言文件夾中，我們放置 .voc 文件，其中包含確定 Mycroft 將聽什么來觸發(fā)技能的短語或關(guān)鍵字。 ”

我的技能的對(duì)話和 voc 文件有點(diǎn)復(fù)雜。這是Skill-iss-location/dialog/en-us/location.current.dialog：

{{latitude}} latitude {{longitude}} longitude which corresponds to {{toponym}}
The space station is at {{latitude}} latitude {{longitude}} longitude over {{toponym}}
It's at {{latitude}} latitude {{longitude}} longitude, {{toponym}}
The ISS is now over {{toponym}} at {{latitude}} latitude {{longitude}} longitude
{{toponym}} at {{latitude}} latitude and {{longitude}} longitude

術(shù)語{{latitude}}、{{longitude}}和{{toponym}}是在執(zhí)行與此技能關(guān)聯(lián)的__init__.py文件期間填充的值的鍵。您在 python 代碼中獲得的值與這些鍵之間存在一對(duì)一的關(guān)系，這使得提供交互式體驗(yàn)變得非常容易。這些鍵周圍的文本是自由形式的，您可以在此處放置任何內(nèi)容，Mycroft 會(huì)在這些選項(xiàng)中進(jìn)行選擇以進(jìn)行響應(yīng)。

技能的核心在于__init__.py文件。我是這樣看的：用python寫的任何東西，都可以融入技能！有了可用的 Python 庫的數(shù)量和種類，這里沒有限制！該文件有一個(gè)特定的結(jié)構(gòu)，我建議閱讀教程并查看Mycroft.al github 站點(diǎn)中的技能，以了解如何從這里開始。我將在這里詳細(xì)介紹我的代碼。看來這一切都在 Python 2.7 中）。

/test/intent文件夾是什么？我花了一段時(shí)間才開始理解這個(gè)文件夾的用途，我還在學(xué)習(xí)它。為了理解它，這些用 JSON 編寫的文件允許 Mycroft 確保您的技能意圖和您創(chuàng)建的文件中定義的聲音表達(dá)都可以正常工作。他們沒有定義聲音交互，而是測(cè)試它，因此得名。在我比較了來自維基百科的測(cè)試/意圖文件和hello-world技能之前，我并不清楚這一點(diǎn)：

來自 hello-world的測(cè)試/意圖文件之一：

{
 "utterance": "Hello world",
 "intent_type": "HelloWorldIntent",
 "intent": {
   "HelloWorldKeyword": "hello world"
 }
}

這是來自維基百科的技能：

{
 "utterance": "tell me about the first world war",
 "intent_type": "WikipediaIntent",
 "intent": {
   "WikipediaKeyword": "tell me about",
   "ArticleTitle": "the first world war"
 }
}

比較這些文件，幫助我理解了這些文件的作用。該話語是 Mycroft 可能會(huì)聽到的內(nèi)容的示例，其中包含關(guān)鍵字和細(xì)節(jié)。intent_type對(duì)應(yīng)于您的__init__.py文件中定義的意圖處理程序，當(dāng)您比較 JSON 文件的“intent:”鍵時(shí)可以看到，該鍵包含來自您的 vocab 文件的關(guān)鍵字，并且在 wiki 技能的情況下是鍵：值對(duì)通過。

所以這些文件并沒有定義你可能的交互，而是特定的測(cè)試用例，以確保你的技能文件一起工作。

上面沒有顯示可選的/regex文件夾，它包含正則表達(dá)式，幫助 Mycroft 響應(yīng)并解析它所聽到的信息！這是非常令人興奮的，但不是這個(gè)項(xiàng)目的主題。

使用安裝了 Picroft 0.8 的 Raspberry PI 3 編寫技能，需要您熟悉使用 linux 命令行。為了方便編寫這項(xiàng)技能，我在我的 Windows 10 筆記本電腦上使用 atom 編寫了所有需要的文件，然后將所有內(nèi)容上傳到 Github。

為了安裝這項(xiàng)技能，我從我的 github 頁面克隆了存儲(chǔ)庫并從那里開始工作。這不是處理軟件的理想方式。但是，既然我對(duì)這個(gè)過程感到滿意，我可能會(huì)提取模板技能并直接從那里使用nano作為我的編輯器，并正確地將更改推送/合并到我自己的存儲(chǔ)庫中。

該技能必須放在/opt/mycroft/skills 技能文件夾中。使用sudo reboot 重新啟動(dòng)系統(tǒng)后，我可以使用該技能。MSM（Mycroft Skill Manager）提供了一個(gè)工具，但我沒有在這個(gè)項(xiàng)目中使用它。我還有很多東西要學(xué)！

Python 代碼亮點(diǎn)

我發(fā)現(xiàn)通過命令行/納米/語音界面進(jìn)行調(diào)試的過程有點(diǎn)挑戰(zhàn)。因此，我編寫了一個(gè)測(cè)試腳本issTest006.py來調(diào)試__init__.py 意圖函數(shù)處理程序的基本功能，以便在我的桌面上運(yùn)行。

通過確保將非 Mycroft 相關(guān)功能與我的代碼中與 Mycroft 平臺(tái)相關(guān)的錯(cuò)誤分開，這有助于簡(jiǎn)化我的調(diào)試過程。

?

使用測(cè)試腳本驗(yàn)證 python 代碼。

?

我們實(shí)際上只是在這里編寫一個(gè) Python 腳本。該技能在 Python 中被創(chuàng)建為一個(gè)類。要在 Mycroft 環(huán)境中工作，該類必須包含它的功能。這些在教程和模板技能中都有概述：

class HelloWorldSkill(MycroftSkill): 
   def __init__(self): 
   def initialize(self): 
   def handle_thank_you_intent(self, message): 
   ... 
   def stop(self): 
def create_skill(): 
   return HelloWorldSkill() 

就我而言，我修改了這個(gè)模板以適應(yīng) ISS 定位技能：

__init__(self)函數(shù)用于創(chuàng)建 Skill 的實(shí)例：

class ISSLocationSkill(MycroftSkill):
   def __init__(self):
       super(ISSLocationSkill, self).__init__(name="ISSLocationSkill")
   ...

這與任何其他 Python 類的__init__(self)構(gòu)造函數(shù)沒有什么不同。我沒有要在這里設(shè)置的實(shí)例變量，所以這就是這里所需要的。

def initialize(self)是我們構(gòu)建意圖和注冊(cè)意圖處理程序的地方。就我而言，只有一個(gè)。

您還可以在此處看到傳遞給函數(shù)的值匹配文件名、關(guān)鍵字 .voc 或我們之前編碼中的 JSON 鍵。這是關(guān)鍵字、意圖測(cè)試和意圖處理程序之間建立聯(lián)系的地方。因此，遵守 Mycroft 平臺(tái)的命名約定很重要。

def initialize(self):
       iss_location_intent = IntentBuilder("ISSLocationIntent").require("ISSKeyword").build()
       self.register_intent(iss_location_intent, self.handle_intent)
...

我的技能只有一個(gè)意圖，但您可以從Hello World Skill 中看到注冊(cè)多個(gè)意圖處理程序的樣子：

def initialize(self):
       thank_you_intent = IntentBuilder("ThankYouIntent"). \
           require("ThankYouKeyword").build()
       self.register_intent(thank_you_intent, self.handle_thank_you_intent)
       how_are_you_intent = IntentBuilder("HowAreYouIntent"). \
           require("HowAreYouKeyword").build()
       self.register_intent(how_are_you_intent,
                            self.handle_how_are_you_intent)
       hello_world_intent = IntentBuilder("HelloWorldIntent"). \
           require("HelloWorldKeyword").build()
       self.register_intent(hello_world_intent,
                            self.handle_hello_world_intent)

我的技能的大部分代碼都包含在意圖處理程序中，這與稀疏的Hello World Skill 意圖處理程序形成對(duì)比。他們只需將 Mycroft 指向?qū)υ捒蛭募纯稍L問：

def handle_how_are_you_intent(self, message):
       self.speak_dialog("how.are.you")

需要注意的是，傳遞的值是執(zhí)行技能時(shí)要訪問的對(duì)話文件的名稱，而不是您希望 Mycroft 說出的實(shí)際文本！傳遞的值是不帶.dialog擴(kuò)展名的文件名。

讓我們深入了解我的意圖處理程序，并嘗試關(guān)注來自意圖處理程序的信息是如何傳遞回 Mycroft 的。

我們要做的第一件事是從 open-notify 獲取當(dāng)前 ISS 位置。我們使用urllib2庫發(fā)出請(qǐng)求，然后使用json解析 JSON 有效負(fù)載響應(yīng)（請(qǐng)注意，urllib2 不是 Python3 中的單個(gè)庫）。

 def handle_intent(self, message):
       # get the 'current' latitude and longitude of the ISS from open-notify.org in JSON
       reqISSLocation = urllib2.Request("http://api.open-notify.org/iss-now.json")
       resISSLocation = urllib2.urlopen(reqISSLocation)
       issObj = json.loads(resISSLocation.read()) # JSON payload of ISS location data
       latISS = issObj['iss_position']['latitude']
       lngISS = issObj['iss_position']['longitude']

你能看出上面的代碼有問題嗎？我可以并且經(jīng)歷過。如果 Open-Notify 的服務(wù)器已關(guān)閉或連接出現(xiàn)問題，會(huì)發(fā)生什么情況？這將導(dǎo)致程序崩潰。它不會(huì)使 Mycroft 崩潰，它只是不會(huì)為這種“錯(cuò)誤”情況提供可接受的語音響應(yīng)，讓用戶（像我一樣）想知道到底發(fā)生了什么。為了糾正這個(gè)問題，在未來的版本中，我將使用 Python 中最棒的異常處理機(jī)制，就像我在后面的代碼中所做的那樣。

接下來，我們將使用從 Open-Notify 中解析出的 JSON 有效負(fù)載中的緯度和經(jīng)度來創(chuàng)建 URL 請(qǐng)求字符串以訪問GeoNames.org Web 服務(wù)。我們?cè)谶@里創(chuàng)建 2 個(gè)字符串，因?yàn)閷?duì)陸地和海洋/水特征有不同的反向地理編碼 api 調(diào)用：

...
oceanGeoNamesReq = "http://api.geonames.org/oceanJSON?lat="+ latISS +"&lng="+ lngISS +"&username=YourUserName"
landGeoNamesReq  = "http://api.geonames.org/countryCodeJSON?formatted=true&lat=" + latISS + "&lng=" + lngISS +"&username=YourUserName&style=full"
...

不要忘記將您的用戶名插入到上面的字符串中！

盡管國際空間站的軌道旨在一次覆蓋全球 90% 的人口，但地球是 3/4 的水，每當(dāng)我看時(shí)，大部分軌道似乎都在一片水域之上。因此，正如下面代碼中的注釋所示，我們首先檢查坐標(biāo)是否將地理編碼反向到海洋位置。再次在這里我應(yīng)該把它放在異常處理塊中。未來的東西。. .

# Since the Earth is 3/4 water, we'll chek to see if the ISS is over water first;
       # in the case where this is not so, we handle the exception by  searching for a country it is
       # over, and is this is not coded for on GenNames, we just we say we don't know
       oceanGeoNamesRes = urllib2.urlopen(oceanGeoNamesReq)
       toponymObj = json.loads(oceanGeoNamesRes.read())

在下一段代碼中，我們絕對(duì)必須將其包裝在異常處理塊中。當(dāng)我們嘗試從海洋位置解析從GeoNames.org返回的 JSON 有效負(fù)載時(shí)，如果國際空間站位于陸地上方，則會(huì)產(chǎn)生錯(cuò)誤，因?yàn)橛行ж?fù)載中不存在海洋名稱密鑰。

如果我們得到這個(gè)錯(cuò)誤，我們的第一個(gè)假設(shè)將是我們?cè)陉懙厣稀?/font>因此，我們將嘗試訪問土地的反向地理編碼服務(wù)。實(shí)際上，我們可以通過檢查返回的狀態(tài)/錯(cuò)誤代碼來使這更復(fù)雜，但是這個(gè)假設(shè)，陸地與水體，似乎工作得很好：

try:
           toponym = "the " + toponymObj['ocean']['name']
       except KeyError:
           landGeoNamesRes = urllib2.urlopen(landGeoNamesReq)
           toponymObj = json.loads(landGeoNamesRes.read())
           toponym = toponymObj['countryName']
       except:
           toponym = "unknown"

if toponym == "unknown":
           self.speak_dialog("location.unknown",{"latitude": latISS, "longitude": lngISS})
      else:
           self.speak_dialog("location.current",{"toponym":toponym, latitude": latISS, "longitude": lngISS})