woyaocd下載 - woyaocd原始碼下載

woyaocd

Ai源碼

1.0.0

下載

[master]分支是經典版本，[v2_map_index]是地圖首頁版本（注意，地圖顯示的是開發者的數據，你沒有買設備，所以是空的）

0. 小牛充電插件

用來開發電動車/電動單車充電微信小程式的插件，開發者可以在自己的程式中直接呼叫插件功能以執行充電的所有操作，包括啟動、計費、支付、監控等而無需要額外的軟體開發。此插件僅支援小牛新能源公司生產的硬體設備，包括汽車交流充電樁，汽車直流充電樁，一拖十二單車充電樁等產品。 ©深圳小牛新能源有限公司2018

0.1 相關術語

主微信小程式：合作夥伴開發的具有自主品牌的微信小程式小牛新能源插件：由小牛新能源公司開發的可以直接在主微信小程式中引用的插件小牛新能源充電樁：由小牛新能源公司研發的硬體設備，包括汽車充電樁和單車充電樁主程式APPID：合作夥伴向騰訊公司申請的主微信小程式APPID充電外掛APPID：由小牛公司向騰訊公司申請的外掛程式APPID，即：wx5a3782a4284eacc4

0.2 有什麼好處

合作夥伴擁有完全自主的品牌標識
合作夥伴擁有完全自主的客戶服務
合作夥伴擁有完全自主的客戶數據
完整的硬體產品線，電動自行車充電，電動車充電，小牛公司完全自主研發
提供全面的技術支援和入門指導，快速開發，快速上線
提供完整可用的插件呼叫原始碼，具備完整的充電功能，可擴展性強，合作夥伴可自行添加任意功能
完全免費的案例原始碼，無需軟體開發經驗，10分鐘創建自己的充電小程序
零門檻，低風險，10分鐘擁有自己的APP，20分鐘擁有自己的品牌，30分鐘創建自己的充電站

1. 最簡上手步驟

1.1 從入門到精通

準備好營業執照/銀行開戶許可證掃描件/管理員身份證，訪問https://mp.weixin.qq.com/申請微信小程序，記下appid，已經申請的跳過
在微信公眾平台（微信小程式後台https://mp.weixin.qq.com/,設定->第三方服務->新增插件)新增“小牛充電插件”
下載原始碼(參考##1.2)解壓縮
運行開發工具，新建項目，輸入appid，選擇解壓縮項目資料夾
運行測試，真機預覽，上傳，提交審核，提交發布，上線
進行商務對接，採購設備，測試設備
產生二維碼，交付工廠進行大量生產

從入門到精通

1.2 下載原始碼(複製到瀏覽器)：

http://file.woniuev.cn/xndemo.zip http://file.woniuev.cn/xndemo_map.zip 想要最快速度擁有自己的充電APP，只要使用上面的原始碼就可以了。下面的章節都是針對原始碼的應用程式進行說明，有了原始碼，任何說明都不需要。微信小程式名字申請需要與公司名字相近。

1.3 建立二維碼

在原始碼的tools目錄下有qrcodemaker1.js這個文件，按上圖操作，就可以建立二維碼了。

1.4 充電程序外觀1

程式範例

1.5 充電程序外觀2

程式範例

1.6 充電程序外觀3

程式範例

1.7 充電程序外觀4

程式範例

2. 插件開放接口

2.1 初始化插件

主微信小程式要呼叫插件接口，需要先初始化：

    var xnplugin = requirePlugin("xnplugin");

建立二維碼

2.2 插件登陸檢查程式碼

用來檢查充電用戶是否已經登陸插件，如果未登陸，可以引用2.3的按鈕來登陸，也可以在小牛新能源插件頁內點擊登陸。

    var xnplugin = requirePlugin("xnplugin");
    var vserInfo = xnplugin.getVserInfo();
    if (vserInfo==false){
        console.log('用户没有登陆插件');
    }else{
        console.log('用户绑定的手机号', vserInfo.usermobile);
    }

退出外掛登陸狀態：

    xnplugin.setVserInfo(false);

xnplugin.getVserInfo() 回傳值中有用欄位清單： vserInfo.usermobile: 客戶的手機號碼，為空不能充電vserInfo.openid: 客戶的OPENID，不能為空vserInfo.balance: 保留兩位小數的帳戶餘額vserInfo.balanum : 數位型帳戶餘額vserInfo.pakingid: 正在停車使用的充電樁編號（汽車） vserInfo.reghours: 到目前為止註冊的小時數

2.3 插件登陸按鈕

在主微信小程式中直接引用登陸按鈕，不必在小牛新能源外掛頁登陸，更好的使用者體驗。

    <loginbtn
        customtype="primary"
        customtitle="立即登陆插件"
        customstyle="font-size:1.5em;color:green;" />

以上程式碼在一個空白頁面中的實際效果：登陸按鈕實例

2.4 軟體開發建議

由於引入了外掛程式頁面跳轉，而這是最新版才有的功能，所以微信程式必須是最新版本。主微信小程式要注意檢查和引導客戶更新。

3. 汽車充電插件

    <evcar />
    <evcar optid="{{qrscandcode}}"/>
    <evcar optid="{{mycode}}"/>

以上三種文法都可以。 optid表示呼叫者主微信小程式中所取得的電樁編號，可以是掃碼得到的，也可以是其他方式得到的（例如輸入，點連接等）

4. 單車充電插件

    <biker />
    <biker optid="{{qrscandcode}}"/>
    <biker optid="{{mycode}}"/>

以上三種文法都可以。 optid表示呼叫者主微信小程式中所取得的電樁編號，可以是掃碼得到的，也可以是其他方式得到的（例如輸入，點連接等）

5 可選引用插件

這裡列出的其他插件在非必要的情況下，不必引用，因為在插件主入口（biker/evcar）中已經包含了對這些插件的引用和跳躍。主微信小程式只需要引用biker和evcar兩個頁面就可以了。

5.1 帳戶儲值

   <recharge hasback="0" />

可對本客戶帳戶進行儲值。儲值金額直接進入業者支付通道，由業者直接管理。儲值帳戶顯示目前微信小程式的餘額。目前帳戶餘額只能在本業者所屬的電樁上消費。

5.2 儲值歷史

   <chistory hasback="0" />

詳細記錄了每一次充值的日期，金額，來源，並可針對最後一次充值退款。

5.3 單車充電歷史

   <bhistory hasback="0" />

詳細記錄保存了每一次單車充電的日期，電樁/插口號，充電金額，時長及充電功率。

5.4 汽車充電歷史

   <ahistory hasback="0" />

詳細記錄保存了每一次汽車充電的日期，電樁編號，充電電量，充電金額。

5.5 汽車待支付帳單

   <mybill hasback="0" />

汽車充電預設是自動扣款，但是在有超時佔位費的情況下需手動結算，這是支付頁面。電動單車充電是自動扣款，餘額低於5元無法啟動充電（自動充滿）。單車充電和汽車充電都有餘額監測試機制，餘額用光線自動斷電（可能會有少許負數）。

5.6 微信帳戶綁定

   <bindphone hasback="0" />

綁定和解綁手機的頁面，客戶必需要綁定手機才能充電。解綁後不可充電。綁定手機要用簡訊驗證碼驗證。

5.7 簡訊啟動儲值

   <feecard hasback="0" />

此功能由營運合作夥伴決定是否新增。業者可以在營運管理後台產生一批指定面額的虛擬儲值卡，並且可以將虛擬儲值卡的啟動碼透過手機簡訊傳送給指定用戶，用戶收到啟動碼以後可以在本功能裡面填寫並啟動此虛擬儲值卡，並將卡內金額保存在自己的充電帳戶中。業者自行決定此虛擬卡的面額和收費情況，並透過線下實現。 (應用場景：買車送充電卡，租車送充電樁。)

6. 內建掃碼功能

單車充電，汽車充電小牛新能源插件頁面已經內建了掃碼功能，內建掃碼功能可以讓客戶在本頁面不離開直接掃碼。本掃碼功能支援介面B(小程式碼,無限量）和介面C（二維碼,限量）類型的二維碼，具體參考： https://developers.weixin.qq.com/miniprogram/dev /api/qrcode.html 為了保持掃碼統一，主微信小程式有以下建議：單車充電頁取名為xmain/biker.wxml，汽車充電取名為xmain/evcar.wxml B型二維碼參數： {'scene':'10000','page':'xmain/biker','width':430} {'scene':'10002','page':'xmain/evcar','width':430} C型二維碼參數： {'path':'xmain/biker?chgid=190','width':430} {'path':'xmain/evcar?chgid=100180','width':430} 重要：二維碼產生後在APP的電樁詳情頁(充電頁)對每一個碼掃碼一次。

7. 頁面後期工作

無論哪一個插件，在引入到主程式中以後都可以額外添加元素，通常是在插件頁面的最尾部增加按鈕，連接，圖片等。如果加入頁面的元件不想追加到最尾部，可以透過（position:absolute）來實現任意位置定位。合作商可以在自己的主微信小程式中添加更多的功能，以便於實現在地化服務或個人化應用。最後開發合作商自己的功能頁面，上線，交付使用。關於地圖展示的API： xnplugin.getChargerMap(leftlng, rightlng, botlat, toplat, carbk, callback); leftlng，botlat：屏幕西南坐標（WGS84格式）rightlng，toplat：屏幕東北坐標carbk: 0顯示全部站點，1只顯示單車充電站，2只顯示汽車充電站，3只顯示直流充電站callback(markers)：返回站點標記數組。 xnplugin.getChargersInSite(siteid, callback); siteid: 顯示指定充電站的電樁（全部顯示） callback(chargers): 傳回本站的電樁數組關於地圖全螢幕: 範例原始碼沒有地圖全螢幕功能，如需要全螢幕地圖，請聯絡我們提供範例原始碼。

8. 版權申明

充電軟體原始碼免費下載，免費使用，可自行隨意修改，客戶不擁有程式碼所有權，不可申明版權。充電軟體原始碼免費提供，客戶可在此基礎上自已修改，充電軟體一經修改，與小牛新能源沒有任何關係。小牛公司提供給客戶的交付件僅限於小牛新能源插件和本接口文檔，小牛公司有責任長期升級和維護小牛新能源插件，不接受客戶定制。小牛公司願意協助客戶將小程式改用客戶自己名字，自己的LOGO，不接受除此之外的其他修改，但客戶可以自行增加/修改任何內容。增加/修改的部份為自有版權。小牛新能源微信小程式外掛程式版權歸©深圳小牛新能源有限公司所有，客戶可免費使用，客戶不得抄襲，逆向工程等違法活動。小牛新能源硬體設備版權歸©深圳小牛新能源有限公司所有，客戶採購以後擁有產權，使用權，但不得抄襲，逆向工程等違法活動，一經發現，公司保留向違法者提起訴訟的權利。