dUserAgent

init

论坛示例

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

概述

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){
        api.alert({msg: JSON.stringify(ret)});
    }else{
        api.alert({msg: JSON.stringify(err)});
    }
    // 用浏览器自带接口查看当前浏览器的UserAgent是否成功替换
    alert(navigator.userAgent);
});

注意：iOS中默认已将UserAgent初始化完毕，可以不调用(调用也没问题)；Android中需要进行初始化。

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

是否仍需要帮助？ 请保持联络！
最后更新于 2024/04/24