寫在前面

H5+ 所有功能都只能在 plusReady 事件加載完成后調用

mui.plusReady(function() { // 擴展API加載完成事件var self = plus.webview.currentWebview();mui.alert(self);});

獲取設備信息

mui.alert("設備的國際移動設備身份碼 " + plus.device.imei);mui.alert("設備的國際移動用戶識別碼 " + plus.device.imsi);mui.alert("設備的型號 " + plus.device.model);mui.alert("設備的唯一標識 " + plus.device.uuid);

addEventListener 添加事件監聽函數

void document.addEventListener( event, callback, capture );參數：event: ( DOMString ) 必選 要添加監聽的事件類型，可取下面面列出的所有事件常量callback: ( EventTrigCallback ) 必選 擴展API加載完畢觸發的回調函數capture: ( Boolean ) 可選 事件流捕獲順序，可忽略事件常量"plusready": 擴展API加載完成事件"pause": 運行環境從前臺切換到后臺事件"resume": 運行環境從后臺切換到前臺事件"netchange": 設備網絡狀態變化事件"newintent": 新意圖事件"plusscrollbottom": 窗口滾動到底部事件"error": 頁面加載錯誤事件mui.plusReady(function(){document.addEventListener('pause',function(){mui.toast('app 在后端運行');},false)document.addEventListener('resume',function(){mui.toast('app 在前端端運行');,false)});// 原生dom事件// 1、利用dom元素的 onclick="" 屬性//HTML代碼 <input type="button" id="btn" value="test" onclick="test();"></input>//js代碼 function test(){alert(1);// 2、獲取dom對象，從寫dom元素的 onclick 方法//HTML代碼 <input type="button" id="btn" value="test"></input>//js代碼 // document.addEventListener('plusready', function(){ // var btn = document.getElementById('btn'); // btn.onclick = function(){alert(1);} // });// 3、a 元素的href屬性//HTML代碼 <a href="javascript:test();">test</a>//js代碼 function test(){alert(1);}

屏幕亮度

// 獲取屏幕亮度 0 - 1之間的數值plus.screen.getBrightness();// 設置屏幕亮度plus.screen.setBrightness( 0.5 );

保持屏幕喚醒

// plus.device.setWakelock( lock );// 參數：// lock: ( Boolean ) 必選 是否設置程序一直保持喚醒狀態// 可取值true或false，true表示設定程序一直保持喚醒狀態，false表示關閉程序一直保持喚醒狀態。程序退出后將恢復默認狀態，默認為關閉程序保持喚醒狀態。 // plus.device.setWakelock(true);// isWakelock 獲取程序是否一直保持喚醒（屏幕常亮）狀態 // if(plus.device.isWakelock()){ // mui.toast('屏幕一直保持喚醒'); // }else{ // mui.toast('屏幕一定時間不操作會鎖屏哦'); // }

屏幕方向

// 鎖定屏幕方向 // void plus.screen.lockOrientation("landscape-primary");//參數 // orientation: ( String ) 必選 要鎖定的屏幕方向值 // 鎖定屏幕方向可取以下值： // "portrait-primary": 豎屏正方向； // "portrait-secondary": 豎屏反方向，屏幕正方向按順時針旋轉180°； // "landscape-primary": 橫屏正方向，屏幕正方向按順時針旋轉90°； // "landscape-secondary": 橫屏方向，屏幕正方向按順時針旋轉270°； // "portrait": 豎屏正方向或反方向，根據設備重力感應器自動調整； // "landscape": 橫屏正方向或反方向，根據設備重力感應器自動調整；// 解除鎖定屏幕方向 // void plus.screen.unlockOrientation();

OS 底層系統信息:

// mui.alert("系統語言信息 " + plus.os.language); // mui.alert("系統版本信息 " + plus.os.version); // mui.alert("系統的名稱 " + plus.os.version); // mui.alert("系統的供應商信息 " + plus.os.vendor);

Screen模塊管理設備屏幕信息：

// 1. resolutionHeight: 設備屏幕高度分辨率// 設備屏幕區域包括系統狀態欄顯示區域和應用顯示區域，screen獲取的是設備屏幕總區域的邏輯分辨率，單位為px。 如果需要獲取實際分辨率則需要乘以比例值scale。 // mui.alert("Screen height: " + (plus.screen.resolutionHeight * plus.screen.scale) + "px" );// 2. resolutionWidth: 設備屏幕寬度分辨率// 設備屏幕區域包括系統狀態欄顯示區域和應用顯示區域，screen獲取的是設備屏幕總區域的分辨率，單位為px。 如果需要獲取實際分辨率則需要乘以比例值scale。 // mui.alert( "Screen width: " + (plus.screen.resolutionWidth * plus.screen.scale) + "px" );// 3. scale: 邏輯分辨率與實際分辨率的比例 // mui.alert("邏輯分辨率與實際分辨率的比例 "+ plus.screen.scale);// Display模塊管理應用可使用的顯示區域信息：// 應用可使用的屏幕高度邏輯分辨率 plus.display.resolutionHeight;// 應用可使用的屏幕寬度邏輯分辨率 plus.display.resolutionWidth;

撥打電話

// plus.device.dial(number, true);// 參數一（String）——必選 ，要撥打的電話號碼 參數二（Boolean ）——可選，是否需要用戶確認后開始撥打電話// 設置為true表示打開系統撥打電話界面，需用戶點擊撥號按鈕后才開始撥打電話，false則無需確認直接撥打電話，默認值為true。// 返回值：// void : 無// 平臺支持： Android - 2.2+ (支持)，iOS - 5.1+ (支持): 忽略confirm參數，調用直接撥打電話。 // plus.device.dial('10086', false);

設備震動

// plus.device.vibrate( milliseconds );// 參數：// milliseconds: ( Number ) 必選 設備振動持續的時間// 數值類型，單位為ms，默認為500ms。// plus.device.vibrate(600);

Device模塊用于獲取網絡信息

// 常量：// CONNECTION_UNKNOW: 網絡狀態常量，表示當前設備網絡狀態未知，固定值為0。// CONNECTION_NONE: 網絡狀態常量，當前設備網絡未連接網絡，固定值為1。// CONNECTION_ETHERNET: 網絡狀態常量，當前設備連接到有線網絡，固定值為2。// CONNECTION_WIFI: 網絡狀態常量，當前設備連接到無線WIFI網絡，固定值為3。// CONNECTION_CELL2G: 網絡狀態常量，當前設備連接到蜂窩移動2G網絡，固定值為4。// CONNECTION_CELL3G: 網絡狀態常量，當前設備連接到蜂窩移動3G網絡，固定值為5。// CONNECTION_CELL4G: 網絡狀態常量，當前設備連接到蜂窩移動4G網絡，固定值為6。// 使用getCurrentType函數獲取設備當前連接的網絡類型 // plus.networkinfo.getCurrentType();// 檢測網絡狀態變化 // mui.plusReady(function(){ // document.addEventListener("netchange", function(){ // var nt = plus.networkinfo.getCurrentType(); // switch ( nt ) { // case plus.networkinfo.CONNECTION_ETHERNET: // case plus.networkinfo.CONNECTION_WIFI: // mui.alert("切換到wifi!"); // break; // case plus.networkinfo.CONNECTION_CELL2G: // case plus.networkinfo.CONNECTION_CELL3G: // case plus.networkinfo.CONNECTION_CELL4G: // mui.alert("切換到4G網絡!"); // break; // default: // mui.alert("無網絡!"); // break; // } // }, false ); // });

nativeUI系統原生界面管理

// 1、actionSheet: 彈出系統選擇按鈕框 // void plus.nativeUI.actionSheet( actionsheetStyle, actionsheetCallback );// 說明：從底部動畫彈出系統樣式選擇按鈕框，可設置選擇框的標題、按鈕文字等。 彈出的提示框為非阻塞模式，用戶點擊選擇框上的按鈕后關閉，并通過actionsheetCallback回調函數通知用戶選擇的按鈕。// 參數： // actionsheetStyle: ( ActionSheetStyle ) 必選 選擇按鈕框顯示的樣式 // actionsheetCallback: ( ActionSheetCallback ) 可選 選擇按鈕框關閉后的回調函數// plus.nativeUI.actionSheet( {title:"test",cancel:"取消",buttons:[{title:"1"},{title:"2"}]}, function(e){ // // e.index 代表選擇按鈕的序列號 // console.log( "User pressed: "+e.index ); // });// 2、alert彈出系統提示對話框// void plus.nativeUI.alert( message, alertCB, title, buttonCapture );// 說明：創建并顯示系統樣式提示對話框，可設置提示對話框的標題、內容、按鈕文字等。 彈出的提示對話框為非阻塞模式，用戶點擊提示對話框上的按鈕后關閉，并通過alertCB回調函數通知對話框已關閉。// 參數： // message: ( String ) 必選 提示對話框上顯示的內容 // alertCB: ( AlertCallback ) 可選 提示對話框上關閉后的回調函數 // title: ( String ) 可選 提示對話框上顯示的標題 // buttonCapture: ( String ) 必選 提示對話框上按鈕顯示的內容// plus.nativeUI.alert('hi boy！',function(){},'test','確定');// 3、confirm 彈出系統確認對話框// void plus.nativeUI.confirm( message, confirmCB, title, buttons );// 說明：創建并顯示系統樣式確認對話框，可設置確認對話框的標題、內容、按鈕數目及其文字。 彈出的確認對話框為非阻塞模式，用戶點擊確認對話框上的按鈕后關閉，并通過confirmCB回調函數通知用戶點擊的按鈕索引值。// 參數： // message: ( String ) 必選 確認對話框上顯示的內容 // confirmCB: ( ConfirmCallback ) 可選 確認對話框關閉后的回調函數 回調函數中包括Event參數，可通過其index屬性（Number類型）獲取用戶點擊按鈕的索引值。 // title: ( String ) 可選 確認對話框上顯示的標題 // buttons: ( Array[ String ] ) 可選 確認對話框上顯示的按鈕 字符串數組，每項對應在確認對話框上顯示一個按鈕，用戶點擊后通過confirmCB返回用戶點擊按鈕的在數組中的索引值。// plus.nativeUI.confirm('確定要刪除嗎？',function(e){ // if(e.index == 1){ // alert('yes'); // } // },'提示', ['否','是0']);// 4、loading等待對話框// closeWaiting: 關閉系統等待對話框// showWaiting: 顯示系統等待對話框 // var w = plus.nativeUI.showWaiting(); // setTimeout(function (){ // w.close();//或者plus.nativeUI.closeWaiting(); // }, 3000);// 5、prompt 彈出系統輸入對話框// void plus.nativeUI.prompt( message, promptCB, title, tip, buttons );// 說明：創建并顯示系統樣式輸入對話框，可設置輸入對話框的標題、內容、提示輸入信息、按鈕數目及其文字。 彈出的輸入對話框為非阻塞模式，其中包含編輯框供用戶輸入內容，用戶點擊輸入對話框上的按鈕后自動關閉，并通過promptCB回調函數返回用戶點擊的按鈕及輸入的內容。 // 參數： // message: ( String ) 必選 輸入對話框上顯示的內容 // promptCB: ( PromptCallback ) 可選 關閉輸入對話框的回調函數 回調函數中包括Event參數，可通過其index屬性（Number類型）獲取用戶點擊按鈕的索引值，通過其value屬性（String類型）獲取用戶輸入的內容。 // title: ( String ) 可選 輸入對話框上顯示的標題 // tip: ( String ) 可選 輸入對話框上編輯框顯示的提示文字 // buttons: ( Array[ String ] ) 可選 輸入對話框上顯示的按鈕數組// plus.nativeUI.prompt('您的姓名',function(e){ // //可通過event.index（Number類型）獲取用戶關閉輸入對話框點擊按鈕的索引值，索引值從0開始 // //通過event.value（String類型）獲取用戶輸入的內容，如果沒有輸入則返回空字符串。 // if(e.index == 0){ // alert(e.value); // } // },'hcoder','請輸入...',['提交','取消']);// 6、toast顯示自動消失的提示消息// void plus.nativeUI.toast( message, options );// 說明： 創建并顯示系統樣式提示消息，彈出的提示消息為非阻塞模式，顯示指定時間后自動消失。 提示消息顯示時間可通過options的duration屬性控制，長時間提示消息顯示時間約為3.5s，短時間提示消息顯示時間約為2s。 // 參數： // message: ( String ) 必選 提示消息上顯示的文字內容 // options: ( ToastOption ) 可選 提示消息的參數 可設置提示消息顯示的圖標、持續時間、位置等。// plus.nativeUI.toast("我會自動離開",{ // align: "center", // 提示消息框在屏幕中的水平位置 "left"、"center"、"right" // duration: "long", // 提示消息框顯示的時間 "long"、"short"，值為"long"時顯示時間約為3.5s，值為"short"時顯示時間約為2s，未設置時默認值為"short"。 // icon: 'images/60x60.gif', // 提示消息框上顯示的圖標 // style: "inline", // 提示消息框上顯示的樣式 "block"表示圖標與文字分兩行顯示，上面顯示圖標，下面顯示文字； "inline"表示圖標與文字在同一行顯示，左邊顯示圖標，右邊顯示文字。 默認值為"block"。 // type: 'text', // "text" - 顯示的消息內容為文本字符串； "richtext" - 顯示的消息內容為富文本內容。 默認值為"text"。 // richTextStyle: { // align:'center' // }, // 富文本樣式 // verticalAlign: "bottom" // 提示消息在屏幕中的垂直位置 可選值為"top"、"center"、"bottom"，分別為垂直居頂、居中、居底，未設置時默認值為"bottom"。 // }); // 7、根據手冊改造loading// 手冊地址：http://www.html5plus.org/doc/zh_cn/nativeui.html // plus.nativeUI.showWaiting('加載中...',{padding:'10px', loading:{display:'inline'}});

// – storage本地數據存儲

// Storage模塊管理應用本地數據存儲區，用于應用數據的保存和讀取。應用本地數據與localStorage、sessionStorage的區別在于數據有效域不同，前者可在應用內跨域操作，數據存儲期是持久化的，并且沒有容量限制。通過plus.storage可獲取應用本地數據管理對象。// getLength: 獲取應用存儲區中保存的鍵值對的個數 // var total = plus.storage.getLength(); // alert(total);// setItem: 修改或添加鍵值(key-value)對數據到應用數據存儲中 // plus.storage.setItem('name','和大喵！');// getItem: 通過鍵(key)檢索獲取應用存儲的值 // var name = plus.storage.getItem('name'); // mui.toast(name);// removeItem: 通過key值刪除鍵值對存儲的數據 // plus.storage.removeItem('name');// clear: 清除應用所有的鍵值對存儲數據 // plus.storage.clear();

// createPlayer()創建音頻對象

// var player = plus.audio.createPlayer('_www/audios/1.mp3'); // // player.play(function(){ // //播放完畢 // alert("Audio play success !!"); // }, function (e){ // alert("Audio play error: " + e.message); // }); // // // stop: 停止播放音頻 // setTimeout(function () { // player.stop(); // },10000)

?

總結

以上是生活随笔為你收集整理的H5+ 常用API(拨打电话,设备震动,屏幕方向,屏幕亮度,设备信息...等)的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。