dUserAgent

来自于：开发者立即使用

init

论坛示例

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

概述

User Agent 简介

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

dUserAgent 模块概述

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

模块使用攻略

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

  • 名称：dUserAgent
  • 参数：userAgent
  • 配置示例:
  1. <feature name="dUserAgent">
  2.     <param name="userAgent" value="%%OS_VER%%  %%OS_NAME%%  %%MODEL%%  %%APP_VER%%  %%APP_VER_CODE%%  %%APP_NAME%%  %%UA%%"/>
  3. </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对象
  • 内部字段：
  1. {
  2.     status: 'success',      //字符串型；success||error，设置UserAgent是否成功
  3.     msg:''                    //字符串型：成功或失败所返回的信息
  4. }

err：

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

示例代码

  1. var dUserAgent = api.require('dUserAgent');
  2. dUserAgent.init(function(ret, err){
  3.     if(ret){
  4.         alert(JSON.stringify(ret));
  5.     }else{
  6.         alert(JSON.stringify(err));
  7.     }
  8.     // 用浏览器自带接口查看当前浏览器的UserAgent是否成功替换
  9.     alert(navigator.userAgent);
  10. });

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

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本