UC手机浏览器(U3内核)相关文档整理

Note:绝大多数API在IOS版下不支持,使用前请自行测试。

UC官方的开发者中心:http://www.uc.cn/business/developer.shtml

 

 

U3内核定制<meta>标签说明

1. 屏幕方向(screen-orientation)

参数:

  • landscape:强制横屏
  • portrait:强制竖屏

用法:

1 <!--  强制横屏  -->
2 <meta name="screen-orientation" content="landscape">

版本支持:8.6+

 

2. 全屏控制(full-screen) 

参数:

  • yes:强制全屏

用法:

1 <!--  强制全屏  -->
2 <meta name="full-screen" content="yes">

提示:用此方法触发的全屏模式,和用户手动在设置项选择的全屏模式是不同的。

版本支持:8.6+

 

3. 浏览模式(browsermode) 

描述:应用模式是为方便web应用及游戏开发者设置的综合开关,通过meta标签进行指示打开,当进入应用模式时,浏览器将自动调整以下参数:

  • (参数: 状态)
  • 全屏: 生效,可通过meta或js api调用退出全屏
  • 长按菜单: 失效,可通过js api调用重新生效
  • 浏览器默认手势: 失效,可通过js api调用重新生效
  • 排版模式: 标准模式,可通过meta或js api调用设置其他排版模式
  • 强制图片显示: 生效
  • 夜间模式: 失效,可通过meta或js api调用启用夜间模式

参数:

  • application:应用模式

用法:

1 <!--  应用模式  -->
2 <meta name="browsermode" content="application"/>

版本支持:8.6+

 

4. UC适应屏幕的排版方式(viewport) 

描述:开启后,当进行缩放操作时,仅放大图片和文字等页面元素,但不放大屏幕宽度,从而避免了左右滚动条的产生。

参数:

  • uc-fitscreen=no:不开启【默认】
  • uc-fitscreen=yes:开启

用法:

1 <!--  开启UC适应屏幕的排版方式  -->
2 <meta name="viewport" content="uc-fitscreen=yes"/>

版本支持:8.5 patch +

 

5. UC适应屏幕的排版方式(layoutmode) 

参数:

  • fitscreen:适应屏幕
  • standard:标准模式

用法:

1 <!--  适应屏幕  -->
2 <meta name="layoutmode" content="fitscreen" />

等同于

1 <meta name="viewport" content="uc-fitscreen=yes, initial-scale=1.0" />

提示:更推荐用layoutmode,避免和原生支持的viewport发生未知冲突。

版本支持:8.5 patch +

 

 6. 禁用夜间模式(nightmode) 

参数:

  • disable:禁止页面使用uc浏览器自定义的夜间模式,进入夜间模式时的表现同日间模式
  • enable:允许页面使用uc浏览器自定义的夜间模式,用于取消disable时的效果

用法:

1 <!--  禁用夜间模式  -->
2 <meta name="nightmode" content="disable"/>

版本支持:8.5 patch +

 

7. 强制图片显示(imagemode) 

描述:当用户使用无图模式时,可以通过此方法来强制显示图片。

参数:

  • force:强制图片显示

用法:

1 <!--  Meta标签(所有图片)  -->
2 <meta name="imagemode" content="force"/>
3 
4 <!--  Img标签(单张图片)  -->
5 <img src="..." show="force">

版本支持:8.5 patch +

 

8. 发送到桌面

描述:在用户触发“发至桌面”的菜单操作后,即触发联网获取size最大的图片。在未获取到图片前,可以先显示默认图片;获取完成后再将获取到的图片更新到桌面。如果获取不到或者没有此特殊标签,仍然使用默认的桌面书签图标。

用法:

1 <link rel="apple-touch-icon-precomposed" sizes="57x57" href="images/icon.png" />
2 <link rel="apple-touch-icon" sizes="72x72" href="images/icon.png" />

 

 

U3内核JavaScript专用API

(经测试,官方文档给出的API很多也不能使用,下面只列出测试能用的)

1. 关闭默认手势

用法:

1 navigator.control.gesture(false);

个人推荐写法:

1 try {
2     navigator.control.gesture(false);
3 } catch (e) {
4     // ...
5 }

 

2. 关闭长按弹出菜单

用法:

1 navigator.control.longpressMenu(false);

个人推荐写法:

1 try {
2     navigator.control.longpressMenu(false);
3 } catch (e) {
4     // ...
5 }

 

 

服务器端相关API

1. XUCBrowserUserAgent

描述:HTTP Header 中 X-UCBrowser-UA 的对象模型,用于封装相关的数据段,并提供简单易用的方法读取字段内容。 

通过这个API,可以获取到更加详细的设备信息,如:网络情况、系统环境、UC浏览器版本等...

各项参数的含义,请查看该pdf:http://www.uc.cn/download/UCBrowser_User_Agent.pdf

php的用法:

1 <?php
2 echo $_SERVER[‘HTTP_X_UCBROWSER_UA‘];

郑重声明:本站内容如果来自互联网及其他传播媒体,其版权均属原媒体及文章作者所有。转载目的在于传递更多信息及用于网络分享,并不代表本站赞同其观点和对其真实性负责,也不构成任何其他建议。