URL scheme是App提供給外部的可以直接操作App的規(guī)則，場(chǎng)景的手機(jī)app都會(huì)定義自己的URL Scheme規(guī)則，如淘寶的taobao://，微信的weixin://。主要用于不同app之間進(jìn)行跳轉(zhuǎn)，當(dāng)然也可以從網(wǎng)頁(yè)跳轉(zhuǎn)到app，跟網(wǎng)頁(yè)的超鏈接跳轉(zhuǎn)作用是類似的。

需要說(shuō)明的是，生成的URL scheme只能被一個(gè)用戶打開（同一個(gè)用戶可以重復(fù)打開），如果一個(gè)鏈接被用戶打開過(guò)，其他用戶打開會(huì)報(bào)錯(cuò)。同時(shí)，單天生成Scheme+URL Link數(shù)量上限是50萬(wàn)條。目前該功能僅對(duì)非個(gè)人小程序賬號(hào)開放權(quán)限，也就是以個(gè)人身份注冊(cè)的小程序不能使用該接口能力。

自 2022 年 4 月 11 日起，URL Scheme有效期最長(zhǎng) 30 天，不再支持永久有效的URL Scheme、不再區(qū)分短期有效URL Scheme與長(zhǎng)期有效URL Scheme。

請(qǐng)求地址

https://api.weixin.qq.com/wxa/generatescheme?access_token=ACCESS_TOKEN

其中ACCESS_TOKEN就是通過(guò)getAccessToken獲取的access_token（有效期為2個(gè)小時(shí)，可以緩存），也就是這樣的信息：

57_ojAsr9tfw8gYoFuSN8XFeuHFGLOScdq75sZL4qVTnUF_YPxiJdJEPiPH1JB9NFxv3OsvTjTtcRf3aNMTl1BEAcZbBmPzCsuYoZYuXQtx8V11w68XtcuzRNC692aWZCXdIAj_8Zd1-N8ebMfo****ABAOFB

請(qǐng)求參數(shù)如下：

一般的我們需要jump_wxa的的參數(shù)，如果不設(shè)置，則自動(dòng)跳轉(zhuǎn)到小程序設(shè)置的主頁(yè)，jump_wxa包括如下參數(shù)：

1、path：通過(guò) scheme 碼進(jìn)入的小程序頁(yè)面路徑，必須是已經(jīng)發(fā)布的小程序存在的頁(yè)面，不可攜帶 query。path 為空時(shí)會(huì)跳轉(zhuǎn)小程序主頁(yè)（如/pages/index/index）；

2、query：通過(guò) scheme 碼進(jìn)入小程序時(shí)的 query（也就是小程序頁(yè)面的參數(shù)），最大1024個(gè)字符，只支持?jǐn)?shù)字，大小寫英文以及部分特殊字符：`!#$&’()*+,/:;=?@-._~%“；

3、env_version：要打開的小程序版本。正式版為”release”，體驗(yàn)版為”trial”，開發(fā)版為”develop”，僅在微信外打開時(shí)生效。默認(rèn)為“release”（也就是正式版）。

簡(jiǎn)單的服務(wù)端demo代碼如下：

?$jssdk = new \jssdk\Jssdk($this->config['appid'],$this->config['secret']);
 $access_token= $jssdk->getAccessToken();//獲取token
 $url='https://api.weixin.qq.com/wxa/generatescheme?access_token='.$access_token;
 $params=[
    'jump_wxa'=>[
       'path'=>'/pages/goods/view/view',
       'query'=>'goods_id=50'
    ] 
 ];
 $res = $this->post($url, json_encode($params));//請(qǐng)求微信服務(wù)端
 echo $res;

返回的信息如下：

直接在微信app內(nèi)使用weixin://打開的效果如下：

也可以在外部h5網(wǎng)頁(yè)（這樣可以在手機(jī)瀏覽器，微博、抖音等第三方app中使用h5鏈接打開），效果如下：

至于有啥用，這個(gè)得看你的應(yīng)用場(chǎng)景，總的來(lái)說(shuō)就是在外部可以打開小程序的任意頁(yè)面路徑。比如在抖音中引導(dǎo)粉絲關(guān)注公眾號(hào)或個(gè)人微信賬號(hào)，就可以通過(guò)跳轉(zhuǎn)到小程序，然后小程序頁(yè)面中嵌入微信二維碼進(jìn)行長(zhǎng)按識(shí)別直接添加微信號(hào)等。