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‘];