基於科大訊飛AIUI平臺自定義語義庫的開發
阿新 • • 發佈：2018-12-30
說明：我寫這篇文章的主要目的是因為我在做這塊的時候遇到過一些坑，也是希望後來者能少走一些彎路。
1. 科大訊飛介面服務類：
<?php namespace service; /** * 科大訊飛AIUI服務 * Class AIUIService * @package service */ class AIUIService { const APP_ID = '*****'; //訊飛AIUI開放平臺註冊申請應用的應用ID(appid) const API_KEY = '****'; //介面金鑰，由訊飛AIUI開放平臺提供，呼叫方管理 const TOKEN = '*****'; //後處理token const AES_KEY = '*****'; //加密AES KEY /** * @title 建構函式 * @param string $key 金鑰 * @param string $method 加密方式 * @param string $iv iv向量 * @param mixed $options 還不是很清楚 */ public function __construct() { $this->token = self::TOKEN; // key是必須要設定的 $this->secret_key = self::AES_KEY; $this->method = "AES-128-CBC"; $this->iv = self::AES_KEY; $this->options = OPENSSL_RAW_DATA; } /** * @title 簽名驗證 * @param $token token * @param $timestamp 時間戳 * @param $rand 隨機數 * @param $aesKey $aesKey * @param $sign 客戶端請求介面sign引數值 * @return INT */ public function checkAuth($sign,$timestamp,$rand,$key='') { //按規則拼接為字串 $str = self::createSignature($this->token,$timestamp,$rand,$key); ///校驗簽名字串：0為一致、-1為不一致 if ($str !== $sign) { return -1; } return 0; } /** * @title 生成簽名 * @param $token * @param $timestamp * @param $rand * @param string $aesKey * @return string */ private static function createSignature($token,$timestamp,$rand,$key='') { //組裝要排序的陣列 $arr = [$timestamp,$token,$rand]; //字典序排序 sort($arr); //拼接為一個字串 $str = implode('',$arr); //sha1加密 return sha1($str); } /** * @title 加密 * @param $plaintext string 要加密的字串 * @return string */ public function encrypt($plaintext){ //加密採用AES的CBC加密方式，祕鑰為16位元組（128bit），初始化向量複用祕鑰，填充方式為PKCS7Padding。 //返回的訊息要以同樣的方式進行加密。 //加密過程：padding->CBC加密->base64編碼 //$option 以下標記的按位或： OPENSSL_RAW_DATA 原生資料，對應數字1，不進行 base64 編碼。OPENSSL_ZERO_PADDING 資料進行 base64 編碼再返回，對應數字0。 return openssl_encrypt($plaintext, $this->method, $this->secret_key,$this->options, $this->iv); } /** * @title 解密 * @param $ciphertext string 要解密的字串 * @return string */ public function decrypt($ciphertext){ //解密過程：base64解碼->CBC解密->unpadding return openssl_decrypt($ciphertext, $this->method, $this->secret_key, $this->options, $this->iv); } }
2. 控制器處理：
介面呼叫示例：
注： 其他具體接入過程可參見文件:https://aiui.xfyun.cn/docs/access_docs
<?php namespace app\api\controller; use service\AIUIService; use service\SimilarityMatch; use think\Db; /** * @title 科大訊飛自定義語義庫 * @class AiUi * @auth 鄒柯 * @date 2018-11-19 */ class AiUi { /** * @title 科大訊飛自定義語義庫 * @return json */ public function accessVerification() { //接收引數 $param = request()->param(false); //判斷介面訪問方式:POST/GET $res = isset($_SERVER['REQUEST_METHOD']) && !strcasecmp($_SERVER['REQUEST_METHOD'],'POST'); if($res) { //POST //是否加密:encrypttype=aes-加密、raw-不加密 $encrypttype = $param[ 'encrypttype']; //解密 if($encrypttype == "aes"){ $DeMsgContent = (new AIUIService())->decrypt(file_get_contents("php://input")); $DeMsgContent = json_decode($DeMsgContent,true); }else{ //訊息內容 $MsgContent = $param['Msg']['Content']; $DeMsgContent = json_decode(base64_decode($MsgContent),true); //除錯程式碼 p($DeMsgContent); } //組裝要返回的問題答案 //應答碼(response code),0-操作成功、4-文字沒有匹配的技能場景,技能不理解或不能處理該文字 if(!empty($DeMsgContent["intent"]) && $DeMsgContent["intent"]["rc"] == 4){ $msg = $this->getMsg($DeMsgContent["intent"]["text"]); if(empty($msg)){ $msg_text = "這個技能還沒學會--測試"; }else{ $msg_text = $msg[0]['answer']; } $DeMsgContent["intent"]["answer"] =[ //通用的文字顯示，屬於text資料 "text"=> $msg_text, //顯示的型別，通過這個型別，可以確定資料的返回內容和客戶端的顯示內容，預設值為 T 。 //T：text資料 U：url資料 TU：text+url資料 IT：image+text資料 ITU：image+text+url資料 "type"=>"T", //回答的情緒，取值參見附錄的情感標籤對照表 "emotion"=>"default", "answerType"=>"openQA" ]; $DeMsgContent["intent"]["operation"] = "ANSWER"; $DeMsgContent["intent"]["score"] = 1; $DeMsgContent["intent"]["service"] = "openQA"; $DeMsgContent["intent"]["status"] = 0; $DeMsgContent["intent"]["array_index"] = 0; $DeMsgContent["intent"]["engine_time"] = 0.001; } //加密 if($encrypttype == "aes"){ //... return (new AIUIService())->encrypt(json_encode($DeMsgContent)); }else{ //除錯程式碼 p(json_encode($DeMsgContent)); echo json_encode($DeMsgContent); } } else { //GET //接收驗證簽名引數 $timestamp = $param['timestamp']; $rand = $param['rand']; $sign = $param['signature']; $AIUIService = new AIUIService(); $res = $AIUIService->checkAuth($sign,$timestamp,$rand); if($res == -1){ return null; } //回傳後處理 token，token 在官網上有 echo sha1("sdjdjsodml"); //除錯程式碼 /********************************** foreach ($_GET as $key=>$value){ file_put_contents("log.txt", date('H:i:s')." "."_GET: Key: $key; Value: $value"."\r\n", FILE_APPEND); } **********************************/ } } /** * @title 根據語義返回要查詢問題的答案 * @param $question 問題 * @return array */ private function getMsg($question){ //匹配主關鍵詞 $keywords_info = Db::query("select * from cr_aiui_keywords where status=1 and LOCATE(keywords,'{$question}') > 0"); if(!empty($keywords_info)){ $keywords_str =implode(",",array_unique(array_column($keywords_info,"keywords"))); $keywords_str2 = "'".str_replace(",","','",$keywords_str)."'"; //組裝查詢條件 $where = "status=1 and keywords in ($keywords_str2)"; $result = Db::name("cr_aiui_semantic_library")->field("id,second_keywords,answer")->where($where)->select(); //計算不同匹配結果的匹配次數 $count = []; foreach($result as $k=>$v){ $count[$v['id']]['count'] = 0; $second_keywords_array = explode(",",$v['second_keywords']); foreach($second_keywords_array as $k2=>$v2){ $res = strpos($question, $v2); $count[$v['id']]['answer'] = $v['answer']; if($res <> false){ $count[$v['id']]['count'] += 1; } } } $count = array_values($count); //多維陣列排序 // 取得列的列表 foreach ($count as $key => $row){ $volume[$key] = $row['count']; } array_multisort($volume, SORT_DESC,$count); //獲取匹配度最大的陣列的次數 $max_count = $count[0]['count']; //組裝匹配次數最大的結果集 foreach($count as $k=>$v){ if($v['count'] <> $max_count ){ unset($count[$k]); } } $count = array_values($count); }else{ return null; } return $count; }
下面是測試過程中的測試資料
(1) 測試資料1
接收post過來的引數：
tp5開啟除錯,檢視日誌記錄：/home/wwwroot/default/CrAdmin/runtime/log/201811/23.log
array (
//隨機字串
'rand' => '04d1L6G2',
//是否加密:encrypttype=aes加密/raw不加密
'encrypttype' => 'raw',
//簽名
'msgsignature' => 'ef64f8ef4ec53a1f7ad30f5c8d312d316e1bd54d',
'timestamp' => '2018-11-19 17:47:23 +0800 CST',
//訊息id，字串型別
'MsgId' => ' (2) 測試資料2
- base64_encode($SessionParams);
{
"context":{
"sdk_support":[
"tts",
"iat",
"nlp"
]
},
"dev_lang":"cpp",
"dsrc":"sdk",
"dtype":"audio",
"interact_mode":"continuous",
"msc.lat":"",
"msc.lng":"",
"os_sys":"Android",
"prot_type":"pb",
"scene":"main",
"scity":"ch",
"sdk_ver":"5.5.1041.0000",
"sid":"[email protected]",
"stmid":"audio-172",
"ver_type":"intelligent_hdw",
"wake_id":"1542620810860e6cfaaba7305867dc4ef3d69"
}(3) 測試資料3
base64_encode($param['Msg']['Content']);
```json
"intent":{
"array_index":0,
"data":{
"inherit":0,
"isCached":0,
"priority":0,
"result":[
{
"albumname":"答案就是你",
"audiopath":"http://vbox.hf.openstorage.cn/ctimusic/128/2016-01-20/%E5%88%98%E5%BE%B7%E5%8D%8E/%E7%AD%94%E6%A1%88%E5%B0%B1%E6%98%AF%E4%BD%A0/%E6%9A%97%E9%87%8C%E7%9D%80%E8%BF%B71453250743.mp3",
"itemid":"45106597",
"movienames":[],
"neatsongname":[
"暗裡著迷"
],
"pictures":[
{
"level":2,
"path":"http://vbox.hfdn.openstorage.cn/ctipicture/2/20160303/580ef3c814d9e33871dfada810f88f3d/09d7de7eb33cc3b65f4e19b43f8bc81e_z.jpg",
"size":"420x420"
},
{
"level":1,
"path":"http://vbox.hfdn.openstorage.cn/ctipicture/2/20160303/580ef3c814d9e33871dfada810f88f3d/09d7de7eb33cc3b65f4e19b43f8bc81e_small.jpg",
"size":"300x300"
}
],
"programname":"",
"publishtime":752083200,
"singeraliasnames":[
"AndyLau",
"劉主席",
"華Dee",
"華仔",
"華哥",
"華神"
],
"singerids":[
"25000"
],
"singernames":[
"劉德華"
],
"songname":"暗裡著迷",
"source":"iflytek",
"tagnames":[
"經典",
"下午茶",
"華語",
"工作",
""
]
},
],
"sem_score":{
"artist":{
"lcs":1,
"pos":"ps",
"txt":"劉德華"
},
"song":{
"lcs":1,
"pos":"ps",
"txt":"暗裡著迷"
},
"top":0
}
},
"demand_semantic":{
"artist":"劉德華",
"service":"musicX",
"song":"暗裡著迷"
},
"engine_time":41.273,
"operation":"PLAY",
"orig_semantic":{
"slots":{
"artist":"劉德華",
"song":"暗裡著迷"
}
},
"rc":0,
"score":0,
"search_semantic":{
"artist":"劉德華",
"operation":"PLAY",
"service":"musicX",
"song":"暗裡著迷"
},
"semantic":{
"slots":{
"artist":"劉德華",
"operation":"PLAY",
"song":"暗裡著迷"
}
},
"service":"musicX",
"uuid":"[email protected]",
"text":"那你豎起耳朵聽劉德華的暗裡著迷",
"state":{
"fg::musicX::default::playing":{
"state":"playing"
}
},
"used_state":{
"state":"playing",
"state_key":"fg::musicX::default::playing"
},
"answer":{
"text":"劉德華 暗裡著迷"
},
"dialog_stat":"DataValid",
"save_history":true,
"sid":"[email protected]",
"cid":"[email protected]"
}
3. 自定義問答庫管理後臺的開發
注：管理後臺的程式碼我就不貼了，主要是原理，如有需要請聯絡我。
4. 資料庫表結構的設計
CREATE TABLE `cr_aiui_keywords` (
`id` int(11) NOT NULL AUTO_INCREMENT,
`keywords` varchar(10) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '關鍵詞',
`status` tinyint(1) NOT NULL DEFAULT '1' COMMENT '狀態（0：禁用 1：啟用）',
`create_time` datetime NOT NULL COMMENT '建立時間',
`update_time` datetime DEFAULT NULL COMMENT '修改時間',
PRIMARY KEY (`id`)
) ENGINE=InnoDB AUTO_INCREMENT=17 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='關鍵詞庫';CREATE TABLE `cr_aiui_semantic_library` (
`id` int(11) NOT NULL AUTO_INCREMENT,
`question` text COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '問題',
`keywords` varchar(255) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '關鍵詞',
`second_keywords` varchar(255) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '副關鍵詞',
`type` tinyint(1) NOT NULL COMMENT '訊息型別:1-文字、2-音訊、3-圖文、4-視訊、5-圖片',
`answer` text COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '訊息內容或標題',
`url` varchar(255) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '視訊、音樂或圖片地址',
`image_url` varchar(255) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '視訊或音樂封面圖片地址',
`desc` varchar(255) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '視訊、音樂描述',
`status` tinyint(1) NOT NULL DEFAULT '1' COMMENT '狀態（0：禁用 1：啟用）',
`create_time` datetime NOT NULL COMMENT '建立時間',
`update_time` datetime DEFAULT NULL COMMENT '修改時間',
PRIMARY KEY (`id`)
) ENGINE=InnoDB AUTO_INCREMENT=11 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='基於科大訊飛AIUI平臺對的自定義語義庫';