# 3.2 語義理解api文檔 </br> ## 3.2.1 SemanticUnderstand 語義理解 * 概要 靈聚人工大腦的語義理解模塊 * getInstance 全局的單一實例 | **函數原型** | static boost::shared_ptr\<SemanticUnderstand\> getInstance() | |--------------------|--------------------------------------------------------------| | **返回** | | | SemanticUnderstand | 全局的單一實例 | * init 初始化靈聚大腦語義分析 | **函數原型** | void init(std::string key, std::string city, std::string lat,std::string lng, int timeoutSeconds) | |----------------|---------------------------------------------------------------------------------------------------| | **參數** | **說明** | | key | 請向靈聚公司申請產品對應的唯一key值 | | city | 當前設備所在城市，（可以為空），用于跟位置相關的問答。例如天氣，附近小吃等。 | | lat | 當前設備所在的經度（可以為空） | | lng | 當前設備所在的緯度（可以為空） | | timeoutSeconds | 每次解析語義允許的最大超時時間 | | **異常** | 已經初始化后再次調用拋出 | | **備注** | 只允許初始化一次，建議放在程序的入口處 | * getAnswer 請求語義分析 | **函數原型** | SemanticResult getAnswer(std::string question) | |-----------------------------------------------|------------------------------------------------| | **參數** | **說明** | | question | 待請求分析的問題 | | **返回** | | | SemanticResult | 語義結果 | | **異常** | 還沒有初始化或者question參數為空字符串拋出 | | **備注** | 線程安全的，同一時間內，只有一條線程運行 | </br> ## 3.2.2 SemanticResult語義理解結果 * getEnum 語義理解的狀態碼 | **函數原型** | enum ResultEnum getEnum() | |-----------------------------------------------|---------------------------| | **返回** | | | ResultEnum| 處理結果狀態碼 | * getStr語義理解的回答 | **函數原型** | std::string getStr() | |--------------|-----------------------------------------------------------------------| | **返回** | | | std::string | 語義理解的回答，只有getEnum()的狀態是resultEnumSuccess,該值才會存在。 | * ResultEnum處理結果狀態碼的枚舉 | **枚舉常量** | **簡介** | |-------------------------|------------------------| | resultEnumSuccess | 請求結果成功 | | resultEnumServiceBusy | 服務器繁忙中或處理超時 | | resultEnumInternetError | 本地網絡異常 | | resultEnumOtherError | 其他罕見錯誤 |