dUserAgent

来自于:开发者立即使用

概述

User Agent 简介

User Agent中文名为用户代理,简称 UA,它是一个特殊字符串头,使得服务器能够识别客户使用的操作系统及版本、CPU 类型、浏览器及版本、浏览器渲染引擎、浏览器语言、浏览器插件等。

dUserAgent 模块概述

dUserAgent 可以自定义UserAgent,并可通过占位符来全新组装所需的UserAgent。

模块使用攻略

使用此模块之前需先配置 config.xml 文件,配置完毕,需通过云端编译生效,使用此插件,请不要再配置官方的字段,如2者都用所导致不能达到所要结果,这并非bug,配置方法如下:

  • 名称:dUserAgent
  • 参数:userAgent
  • 配置示例:
<feature name="dUserAgent">
    <param name="userAgent" value="%%OS_VER%%  %%OS_NAME%%  %%MODEL%%  %%APP_VER%%  %%APP_VER_CODE%%  %%APP_NAME%%  %%UA%%"/>
</feature>
  • 字段描述:

    userAgent:(必须配置)当值为空时为原本的UserAgent,有值时将值赋值到UserAgent中,当存在占位符时会将占位符替换为真正的值。
    %%OS_VER%%:系统版本
    %%OS_NAME%%:系统名称(iOS或Android)
    %%MODEL%%:设备型号
    %%APP_VER%%:软件版本
    %%APP_VER_CODE%%:软件版本号码
    %%APP_NAME%%:软件名称
    %%UA%%:原浏览器User Agent

实例widget下载地址

模块接口

init

初始化所配置的UserAgent,注意:当使用api.openFrame打开的页面需要重新初始化一次,不然设置无效

init(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON对象
  • 内部字段:
{
    status: 'success',      //字符串型;success||error,设置UserAgent是否成功
    msg:''                    //字符串型:成功或失败所返回的信息
}

err:

  • 类型:JSON对象
  • 内部字段:
{
    msg: '请初始化完成后调用'     //字符串型;提示出错的信息
}

示例代码

var dUserAgent = api.require('dUserAgent');
dUserAgent.init(function(ret, err){
    if(ret){
        alert(JSON.stringify(ret));
    }else{
        alert(JSON.stringify(err));
    }
    // 用浏览器自带接口查看当前浏览器的UserAgent是否成功替换
    alert(navigator.userAgent);
});
注意:iOS中默认已将UserAgent初始化完毕,可以不调用(调用也没问题);Android中需要进行初始化。

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本