mobilePhone

目录

插件名称：mobilePhone

Method

gpsstate gpslocation getallapp getPackageName
getOSVersion getSignMd5 getNetWorkType getCallVolume
setVoiceCall getRingVolume SetMediaVolume earpieceSpeaker
battery

论坛示例

为帮助用户更好更快的使用插件，论坛维护了一个示例，示例中包含示例代码、知识点讲解、注意事项等，供您参考。

插件概述

mobilePhone 封装了一些android、IOS系统常用到的与系统设备有关的方法，

例如：获取GPS开关打开状态、获取网络类型、获取手机系统版本、获取并设置手机音量等功能。

详情请参阅下面的接口使用说明。

方法接口描述

GPS开关状态

方法名称：gpsstate()

参数:无

返回参数: gpsstate

返回类型：boolean

可用性：Android/IOS

示例代码：

function getGPSState() {
        var mobilePhoneapi = api.require('mobilePhone');
        mobilePhoneapi.gpsstate({},function(ret, err){
            var state = ret.gpsstate;
            api.toast({
            msg: "gps开关状态为: " + state});
            location: 'middle'
        });
    }

获取GPS坐标

方法名称：gpslocation()

参数:无

返回参数:

latitude(纬度)

longitude(经度)

返回类型：String

可用性：Android/IOS

示例代码：

    // 获取GPS坐标位置
    function getLocation() {
        var mobilePhoneapi = api.require('mobilePhone');
        mobilePhoneapi.gpslocation({},function(ret, err){

            var latitude = ret.latitude;
            var longitude = ret.longitude;
            api.toast({
            msg: "latitude: " + latitude + " longitude: " + longitude});
            location: 'middle'
        });
    }

获取电池电量

方法名称：battery()

参数:无

返回参数: battery

返回类型：int

可用性：Android/IOS

示例代码：

    // 获取电池电量
    function getbattery() {
        var mobilePhoneapi = api.require('mobilePhone');

        mobilePhoneapi.battery({},function(ret, err){

            var batteryValue = ret.battery;
            api.toast({
            msg: "电池电量: " + batteryValue});
            location: 'middle'

        });
    }

获取安装应用列表

方法名称：getallapp()

参数:无

返回参数: namelist

返回类型：ArrayList

可用性：Android/IOS

示例代码：

    // 获取应该安装列表(过滤系统应用)
    function getallapp() {

        var mobilePhoneapi = api.require('mobilePhone');
        mobilePhoneapi.getallapp({},
        function(ret, err){
            var applist = ret.namelist;
            api.toast({
            msg: "应用安装列表: " + applist});
            location: 'middle'
        });

    }

获取当前应用包名

方法名称：getPackageName()

参数:无

返回参数: packageName

返回类型：String

可用性：Android/IOS

示例代码：

    // 获取当前应用包名
    function getPackageName() {
        var mobilePhoneapi = api.require('mobilePhone');
        mobilePhoneapi.getPackageName({},
        function(ret, err){

            var packageName = ret.packageName;
            api.toast({
            msg: "应用包名: " + packageName});
            location: 'middle'
        });
    }

获取系统版本

方法名称：getOSVersion()

参数:无

返回参数: osversion

返回类型：int

可用性：Android/IOS

示例代码：

    // 获取手机系统版本
    function getOSVersion() {
        var mobilePhoneapi = api.require('mobilePhone');
        mobilePhoneapi.getOSVersion({},

        function(ret, err){
            var osversion = ret.osversion;
            api.toast({
            msg: "手机系统版本为: " + osversion});
            location: 'middle'
        });
    }

获取签名的MD5

方法名称：getSignMd5()

参数:无

返回参数: md5

返回类型：String

可用性：Android/IOS

示例代码：

    //获取签名的MD5
    function getSignMd5() {
        var mobilePhoneapi = api.require('mobilePhone');
        mobilePhoneapi.getSignMd5({},

        function(ret, err){
            var md5 = ret.md5;
            api.toast({
            msg: " md5 value: " + md5});
            location: 'middle'
        });
    }

获取网络的类型

方法名称：getNetWorkType()

参数:无

返回参数: networktype

返回类型：String

可用性：Android/IOS

示例代码：

    //获取网络的类型
    function getNetWorkType() {
        var mobilePhoneapi = api.require('mobilePhone');
        mobilePhoneapi.getNetWorkType({},

        function(ret, err){
            var networktype = ret.networktype;
            api.toast({
            msg: " 网络类型为: " + networktype});
            location: 'middle'
        });
    }

获取通话音量

方法名称：getCallVolume()

参数:无

返回参数: callvolume

返回类型：int

可用性：Android/IOS

示例代码：

    //获取通话音量
    function getCallVolume() {
        var mobilePhoneapi = api.require('mobilePhone');
        mobilePhoneapi.getCallVolume({},

        function(ret, err){
            var callvolume = ret.callvolume;
            api.toast({
            msg: " 通话音量为: " + callvolume});
            location: 'middle'
        });
    }

设置通话音量

方法名称：setVoiceCall()

参数:VoiceCallVolume

参数类型：int

返回参数: result

返回类型：String

可用性：Android/IOS

示例代码：

    //设置通话音量
    function setVoiceCall() {
        var mobilePhoneapi = api.require('mobilePhone');
        mobilePhoneapi.setVoiceCall({
            "VoiceCallVolume": 2
        },

        function(ret, err){
            var result = ret.result;
            api.toast({
            msg: " 通话音量设置结果: " + result});
            location: 'middle'
        });
    }

获取铃声音量

方法名称：getRingVolume()

参数:无

返回参数: ringvolume

返回类型：int

可用性：Android/IOS

示例代码：

    //获取铃声音量
    function getRingVolume() {
        var mobilePhoneapi = api.require('mobilePhone');
        mobilePhoneapi.getRingVolume({},

        function(ret, err){
            var ringvolume = ret.ringvolume;
            api.toast({
            msg: " 铃声音量为: " + ringvolume});
            location: 'middle'
        });
    }

设置铃声音量

方法名称：SetMediaVolume()

参数:SetMediaVolume

参数类型：int

返回参数: result

返回类型：String

可用性：Android/IOS

示例代码：

    //设置铃声音量
    function SetMediaVolume() {
        var mobilePhoneapi = api.require('mobilePhone');
        mobilePhoneapi.SetMediaVolume({
            "SetMediaVolume": 2
        },
        function(ret, err){
            var result = ret.result;
            api.toast({
            msg: " 铃声音量设置结果: " + result});
            location: 'middle'
        });
    }

听筒/扬声器切换

方法名称：earpieceSpeaker()

参数:speaker_state

参数类型：boolean true/false( ture代表扬声器 false代表听筒)

返回参数: result

返回类型：String

可用性：Android/IOS

示例代码：

    //听筒/扬声器切换
    function earpieceSpeaker() {
        var mobilePhoneapi = api.require('mobilePhone');
        mobilePhoneapi.earpieceSpeaker({
            "speaker_state": true
        },
        function(ret, err){
            var result = ret.result;
            api.toast({
            msg: " 当前模式: " + result});
            location: 'middle'
        });
    }
是否仍需要帮助？ 请保持联络！
最后更新于 2024/11/18