概述
FNScanner模塊是(shì)一(yī)個(gè)二維碼↔<σ/條形碼掃描器(qì)，底層集成了(le)ZXin" σ✘g，Zbar條形碼/二維碼分(fēn)析庫。調用(λyòng) openScanner 接口打開(kāi)默認UI的(de)二↔↑維碼/條形碼掃描頁面，可(kě)控制(zhì)閃光(guāng"☆)燈開(kāi)關、從(cóng)相(xià↕ng)冊讀(dú)取圖片；開(kāi)發者亦可(kě)通(tōng)過 oα∞γpenView 接口打開(kāi)掃描區(qū)域，自(zì←δ♥)定義其 UI；本模塊還(hái)實現(xiàn)了(le)圖片解碼、字符串₹♦±編碼功能(néng)；開(kāi)發者可(kě)将掃描結果保存×到(dào)系統相(xiàng)冊或指定位置≠π。FNScanner 模塊是(shì) scanner 模塊的(de)優化(≥¶÷huà)版。在 ios 平台上(shàng) autorotatiπ≥←on 功能(néng)僅适用(yòng)于≤§ ios6 以上(shàng)版本
openScanner
打開(kāi)二維碼/條碼掃描器(qì)¶∑
openScanner({params}, callback(r✔σεet))
params
sound：
- 類型：字符串
- 描述：（可(kě)選項）掃描結束後的(de)提示₩&£§音(yīn)文(wén)件(jiàn)路(®♥εlù)徑，要(yào)求本地(dì)路(lù)徑（fs://，widget:>ε§γ//），為(wèi)保證兼容性，推薦使用(yòng) wav ☆ α格式的(de)短(duǎn)音(yīn)頻≥♥λβ(pín)文(wén)件(jiàn)
autorotation:
- 類型：布爾
- 描述：（可(kě)選項）掃描頁面是(shì)否自(zì)動旋轉（橫∏δα豎屏）
- 默認值：false
saveToAlbum:
- 類型：布爾
- 描述：（可(kě)選項）掃描的(de)二維碼≠↑/條形碼圖片是(shì)否自(zì)動保存到(dào)相(xiàng)©↔<冊
- 默認值：false
saveImg：
- 類型：JSON對(duì)象
- 描述：（可(kě)選項）掃描的(de)二$>σ¶維碼/條形碼圖片保存所需要(yào)的(de)參數'←λ (shù)，若不(bù)傳則不(bù)保存
- 內(nèi)部字段：
{ path: 'fs://a.jpg', w: 200, h: 200 }
callback(ret)
ret：
- 類型：JSON對(duì)象
- 內(nèi)部字段：
{ eventType: 'cancel', imgPath: '', albumPath: '', content: '' }
示例代碼
var FNScanner = api.require('FNScanner'); FNScanner.openScanner({ a♥↑∑utorotation: true, },function( ret, err ){ if( ret ){ alert( JSON.stringify( ret ) ); }else{ alert( JSON.stringify( err ) ); ±÷ } });
可(kě)用(yòng)性
iOS系統，Android系統
可(kě)提供的(de)1.0.0及更高(gāo)版本
openView
打開(kāi)可(kě)自(zì)定義的(∏≈±±de)二維碼/條形碼掃描器(qì)
openView({params},callback($∏ret))
params
rect：
- 類型：JSON對(duì)象
- 描述：（可(kě)選項）掃描器(qì)的(de)位♣ 置及尺寸，在安卓平台寬高(gāo)比須跟屏幕寬高(gāo)比一(yī)緻，否>π則攝像頭可(kě)視(shì)區(qū)域的'$(de)圖像可(kě)能(néng)出現(xiàn)少(shǎo)許變形
- 內(nèi)部字段：
{ x: 0, y: 0, w: 320, h: 480 }
sound：
- 類型：字符串
- 描述：（可(kě)選項）掃描結束後的(de)✘ σ提示音(yīn)文(wén)件(jiàn)路(lù↑☆λ)徑，要(yào)求本地(dì)路(lù)徑×≤↔¥（fs://，widget://），為(wèi)保證兼容性，推薦使用(yòng) wa₩λ±v 格式的(de)短(duǎn)音(yīn)頻(pí÷↔$n)文(wén)件(jiàn)
autorotation:
- 類型：布爾
- 描述：（可(kě)選項）掃描頁面是(shì)否自(zì)動旋轉（橫豎屏₹α）
- 默認值：false
saveToAlbum:
- 類型：布爾
- 描述：（可(kě)選項）掃描的(de)二維碼/條♣§形碼圖片是(shì)否自(zì)動保存到(dào)相(xiàng)冊
- 默認值：false
saveImg：
- 類型：JSON對(duì)象
- 描述：（可(kě)選項）掃描的(de)二維碼/條形碼ε>&圖片保存所需要(yào)的(de)參數(shù)，若不(bù)傳則不(b>&λ≥ù)保存
- 內(nèi)部字段：
{ path: 'fs://a.jpg', w: 200, h: 200 }
fixedOn：
- 類型：字符串
- 描述：（可(kě)選項）模塊所屬 Frame 的(de)名字÷₹，若不(bù)傳則模塊歸屬于當前 Window
fixed:
- 類型：布爾
- 描述：（可(kě)選項）模塊是(shì)否随所屬 Window →<✘或 Frame 滾動
- 默認值：true（不(bù)随之滾動）
callback(ret)
ret：
- 類型：JSON對(duì)象
- 內(nèi)部字段：
{ eventType: 'success', imgPath: '', albumPath: '', content: '' }
示例代碼
var FNScanner = api.require('FNScanner'); FNScanner.openView({ ε₽±≈ autorotation: true },function( ret, err ){ if( ret ){ alert( JSON.stringify( ret ) ); ★Ω♠ }else{ alert( JSON.stringify( err ) ); ↑™ } });
可(kě)用(yòng)性
iOS系統，Android系統
可(kě)提供的(de)1.0.0及更高(gāo)版本
setFrame
重設可(kě)自(zì)定義的(de)二維碼/條形碼掃描器(qì)的(deπ★α÷)大(dà)小(xiǎo)和(hé)位置
setFrame({params})
params
x:
- 類型：數(shù)字
- 描述：（可(kě)選項）模塊左上(shà♠↔♦∑ng)角的(de) x 坐(zuò)标（相(xiàng)對(duì≈€)于所屬的(de) Window 或 Frame）
- 默認值：原值
y:
- 類型：數(shù)字
- 描述：（可(kě)選項）模塊左上(shàng)角的(de ) y 坐(zuò)标（相(xiàng)對(duì)于所屬的(de) Win'>εdow 或 Frame）
- 默認值：原值
w：
- 類型：數(shù)字
- 描述：（可(kě)選項）模塊的(de)寬度
- 默認值：原值
h:
- 類型：數(shù)字
- 描述：（可(kě)選項）模塊的(de)高(gāo) 度
- 默認值：原值
示例代碼
var FNScanner = api.require('FNScanner'); FNScanner.setFrame({ x: 10, y: 64, w: 300, h: 300 });
可(kě)用(yòng)性
iOS系統，Android系統
可(kě)提供的(de)1.0.0及更高(gāo)版本
closeView
關閉自(zì)定義大(dà)小(xiǎo>$∑)的(de)二維碼/條碼掃描器(qì)
closeView()
示例代碼
var FNScanner = api.require('FNScanner'); FNScanner.closeView()€★;
可(kě)用(yòng)性
iOS系統，Android系統
可(kě)提供的(de)1.0.0及更高(gāo ♠<♥)版本
decodeImg
二維碼/條形碼圖片解碼
decodeImg({params},callbac≤ ♦→k(ret))
params
sound：
- 類型：字符串
- 描述：（可(kě)選項）掃描結束後的(de)提示音(yīn)文(©↔®☆wén)件(jiàn)路(lù)徑，要(yào)求 →本地(dì)路(lù)徑（fs://，wid§≠×get://），為(wèi)保證兼容性，推薦使用(yòng) wav ✔↓"格式的(de)短(duǎn)音(yīn)頻(pín)文(♣ wén)件(jiàn)
path：
- 類型：字符串
- 描述：（可(kě)選項）要(yào)識别的(de)圖片路(lù)徑，↑要(yào)求本地(dì)路(lù)徑（fs://，w∞φ®αidget://），若不(bù)傳則打開(kāi)系統相(xiàng)冊
callback(ret)
ret：
- 類型：JSON對(duì)象
- 內(nèi)部字段：
{ status: true, content: '' }
示例代碼
var FNScanner = api.require('FNScanner'); FNScanner.decodeImg({ path: 'widget://res/img/apicloud.png' },function( ret, err ){ if( ret.status ){ alert( JSON.stringify( ret ) ); }else{ alert( JSON.stringify( err ) ); } });¶£↓
可(kě)用(yòng)性
iOS系統，Android系統
可(kě)提供的(de)1.0.0及更高(gāo)版本
encodeImg
将字符串生(shēng)成二維碼/條形碼圖片
encodeImg({params},ca₩∞§>llback(ret))
params
type：
- 類型：字符串
- 描述：（可(kě)選項）生(shēng)成圖片的(de)類型，默認值：'qr₽×✔_image'
- 取值範圍
- bar_image（生(shēng)成條形碼圖片）
- qr_image（生(shēng)成二維碼圖片）
content：
- 類型：字符串
- 描述：所要(yào)生(shēng)成的(de)二維碼/條形碼字符串，當 type 為(wèi) bar_image 時(shí)↑♣，該值隻能(néng)為(wèi)數(shù)字字符串
saveToAlbum:
- 類型：布爾
- 描述：（可(kě)選項）掃描的(de)二維碼/條形碼圖片是♣Ω>γ(shì)否自(zì)動保存到(dào)相(xiàng)冊
- 默認值：false
saveImg：
- 類型：JSON對(duì)象
- 描述：（可(kě)選項）掃描的(de)二維碼/條形 Ω碼圖片保存所需要(yào)的(de)參數(shù)，若不>δ★(bù)傳則不(bù)保存
- 內(nèi)部字段：
{ path: 'fs://a.jpg', w: 200, h: 200 }
callback(ret)
ret：
- 類型：JSON對(duì)象
- 內(nèi)部字段：
{ status: true, imgPath: '', albumPath: '', }
示例代碼
var FNScanner = api.require₩"±('FNScanner'); FNScanner.encodeImg({ content: 'http://www.apicloud.com/<>÷', saveToAlbum: true, saveImg: { path: 'fs://album.png', w: 200, h: 200 } },function( ret, err ){ if( ret.status ){ &♥alert( JSON.stringify( ret ) ); }else{ alert( JSON.stringify( err ) );±×♠ } });
可(kě)用(yòng)性
iOS系統，Android系統
可(kě)提供的(de)1.0.0及更高(gāo)版本
switchLight
打開(kāi)/關閉閃光(guāng)燈
switchLight({params})
params
status：
- 類型：字符串
- 描述：（可(kě)選項）打開(kāi)/關閉&β↔閃光(guāng)燈，默認值：'off'
- 取值範圍：
示例代碼
var FNScanner = api.require('FNScanner'); FNScanner.switchL®←™↓ight({ status: 'on' });
可(kě)用(yòng)性
iOS系統，Android系統
可(kě)提供的(de)1.0.0及更高(gā ₽δ←o)版本
