網頁瀏覽器引擎

當前版本	v1.1.3	更新日期	2016.03.30	下載插件
NERvGear	SAO Utils Beta 1 Update 1 以上
系統要求	32/64位 Windows(XP SP2 以上, Vista, 7, 8, 8.1, 10)

[ 網頁瀏覽器引擎 ]插件為 SAO Utils 提供基本網頁瀏覽功能以及 HTML/JavaScript 開發接口支持. 除了與現代瀏覽器一樣, 提供網頁瀏覽, 視頻, 圖片觀看功能外, 還將部分 NERvSDK 標準接口轉換到 HTTP 標準接口, 為網頁開發者提供自制[ 桌面網頁掛件 ]的可能性.

使用說明

安裝并啟用插件后, [ 網頁瀏覽器引擎 ]將接管 SAO Utils 大部分的打開網頁操作, 包括主菜單中所有項目行為是’URL’的操作, [ Bangumi ]的播放按鈕, [ Mail Box ]的”打開 HTML”等. 當打開接管的網頁時, 會彈出一個 SAO 外觀的瀏覽器標簽窗口.

在主菜單中任意項目中, 設定為’URL’行為后, 就可以使用 SAO Utils 內置的瀏覽器打開任意鏈接了.

使用 ‘file:///’ 協議作為 URL 的話, 還能打開本地硬盤上的 HTML 或 HTM 文件.

瀏覽器窗口操作暫時十分簡單: 左上角的圖標是關閉按鈕; 拖動右上角, 左下角和右下角可以更改瀏覽器大小; 右下方的放大鏡圖標可以跳轉到任意鏈接.

除了 2D 模式下的基本操作外, 3D 模式還允許獨立縮放單個瀏覽器窗口. 在瀏覽器窗口上, 按住鼠標右鍵(對應平板等觸摸設備的長按), 然后上(放大)下(縮小)拖動鼠標即可完成縮放操作.

高級選項

本插件基于 CEF 庫開發, 簡單來說就是跟大名鼎鼎的 Chrome, 什么易云音樂 , 什么數字, 什么豹等瀏覽器一樣是基于 Chromium 進行開發的, 因此同樣支持 Chrome 的命令行啟動選項.

通過 “呼出啟動器-設置-Option-插件-網頁瀏覽器引擎” 或 “右鍵任務欄圖標-首選項-插件-網頁瀏覽器引擎-配置” 操作即可彈出命令設置對話框(需要重新啟動 SAO Utils 設置才會生效).
*渲染幀數默認限制為 30 FPS, 如果你的 SAO Utils 正在使用’兼容’ 3D/2D 模式, 或機器性能足夠好的話, 可以在命令行開關中添加選項解除限制:

--max-frame-rate=0

更多 Chromium 命令行開關請參考 List of Chromium Command Line Switches

瀏覽器緩存

內置瀏覽器的緩存默認在

SAO Utils/Configs/Web Browser Engine/Cache

目錄下, 刪除該目錄即可清除所有瀏覽器的緩存和記錄. 特別地, 推薦保留 Cache 目錄下的 Local Storage 文件夾以保留一些網頁掛件的用戶配置信息.

開發接口/API

目前插件提供對傳統 NERvSDK 中數據源接口進行轉換, 以 HTTP GET 請求特定 URL 并且返回 JSON 數據.
返回的 JSON 數據中始終會包含一個名為 “result” 的執行結果, 該值與 COM 的 HRESULT 等價:
當 result >= 0 時成功;
當 result < 0 時失敗.
一般來說正常運行會返回 0 (S_OK), 返回值對應的意義可以參考這里 A lot of HRESULT codes….

數據接口

URL http://nvg-data/

目前有已文檔記載的 數據源, 數據類型, 可以在 NERvLibrary 查到其對應的 ID 和相關說明.

獲取數據的值

GET /{數據源ID}/{數據ID}/{值ID}/query[?param={取值參數}[&unit={取值單位}]]

例子 – 獲取空余物理內存大小并以 MB 為單位返回:

http://nvg-data/00000001-4F00-6144-7461-536f75726365/766A81E5-FC74-4C10-9020-27280857B1CB/0/query?unit=MB

對應 ID 轉換為 NERvSDK 中定義的變量:

http://nvg-data/ID_ODataSource/DATA::ID_RAM/DATA::RAM::U64_PHYSICAL/query?unit=MB

成功的 Response:

{
    "result": 0,            // S_OK
    "data": {
        "value": 10281,     // 空余 10281 MB
        "maximum": 24573,   // 最多 24573 MB
        "minimum": 0,       // 最少 0 MB
        "unit": "MB",       // 單位 "MB"
        "type": 2,          // 數據類型 DATA::UNSIGNED
        "interval": 1000    // 建議更新間隔: 1000 MS
    }
}

失敗的 Response:

{
    "result": -2147467259,  // E_FAIL
    "data": null
}

執行數據對應的動作

GET /{數據源ID}/{數據ID}/{值ID}/invoke[?param={執行參數}]

例子 – 執行支持 CAD 播放器的’下一曲’操作:

http://nvg-data/A60D2B8A-DCD9-4753-9E3F-C9F2B686F34B/26DDF5CF-528B-46b4-B184-19ED771D495D/0/invoke?param=next

對應 ID 轉換為 NERvSDK 中定義的變量:

http://nvg-data/RangerCD::ID_OMusicPlayerDataSource/RangerCD::MusicPlayer::ID_CAD/0/invoke?param=next

本地存取

window.localStorage

如果有需要保存/讀取一些數據, 例如掛件的配置信息, 暫時可以使用 HTML5 標準提供的 localStorage 對象存取”Key-Value”數據. 由于本地文件使用”file:///”協議, 導致所有本地掛件共用同一域的本地存儲對象, 所以在考慮鍵名的事情請盡量使用能夠唯一標記的鍵, 或者直接使用 UUID.
例子 – 存取一個 JSON 對象:

// 存儲 JSON 對象
var user = {'name': 'YUI', 'id': 'MHCP-001'};
localStorage.setItem('GPBeta.YUI', JSON.stringify(user));
// 讀取 JSON 對象
console.log('Hi! ' + JSON.parse(localStorage.getItem('GPBeta.YUI')).name);

已知問題

變更歷史

2016.03.30 – 1.1.3
1. 提升瀏覽器引擎性能和響應速度.
2. 廢除 –max-frame-rate 命令行參數.

2016.01.27 – 1.1.2
1. 修正某些情況下右鍵菜單無法選擇項目.

2015.12.18 – 1.1.1
1. 修正在沒有 SP1 補丁的 64位 Windows 7 或 Vista 系統下, 啟用本插件時程序崩潰.
2. 修正由于顯卡驅動問題造成的網頁空白.
3. 修正無法正常瀏覽操作 PDF 文件.
4. 取消瀏覽器窗口的透明網頁背景.
5. 開發者工具窗口跟隨主窗口自動關閉.

2015.12.11 – 1.1.0
1. 初始版本.

插件下載