WPS协作 网页开放能力

配置网页跳转浏览器打开

通过在网页 URL 中拼接参数 xz_jump_to_browser=true，当WPS协作桌面端点击该页面时，会自动跳转到浏览器打开。

示例：https://open-xz.wps.cn/?xz_jump_to_browser=true

使用说明

客户端	Android	iOS	PC
支持说明	/	/	支持

设置屏幕方向

该能力用于设定网页在屏幕展示的方式，支持强制横屏、强制竖屏、跟随系统设置。

通过在网页 URL 中拼接参数 ksoxzOrientation=landscape/portrait/sensor，当用户点击该页面的时候，根据对应参数决定横屏/竖屏或者跟随系统设置展示应用页面。

示例：https://www.baidu.com?ksoxzOrientation=landscape

使用说明

客户端	Android	iOS	PC
支持说明	支持	支持	/

页面来源参数说明

参数	值	描述	参考示例
openMode	tab	从协作移动端底部主导航打开	https://woa.wps.cn/path/page?openmode=tab
	other	除上述场景外的其他入口打开，如 消息流、机器人、工作台等	https://woa.wps.cn/path/page?openmode=other

参数说明

参数	类型	描述	备注
app_id	string	应用 ID	/
url	string	应用链接（UrlEncode）	/
ksoxzHideNavBar	boolean	控制是否隐藏整个顶部导航栏。 如果为true，则隐藏导航栏如果为false或未设置，则显示导航栏	注：在deeplink中需拼接在url中并Encode
ksoxzHideTitle	boolean	控制是否隐藏导航栏中的标题。 如果为true，则隐藏标题 如果为false或未设置，则显示标题	注：在deeplink中需拼接在url中并Encode
ksoxzShowMenuItem	boolean	控制是否显示导航栏的功能按钮（包括但不限于 【返回】、【更多操作】&【关闭】等）。 如果为true或未设置，则显示导航栏全部按钮 如果为false，则隐藏导航栏全部按钮	注：如果ksoxzHideNavBar为true，此参数将无效，因为整个导航栏都被隐藏了。在deeplink中需拼接在url中并Encode
ksoxzHideNavLeftButton	boolean	控制是否隐藏导航栏的左侧功能按钮（包括但不限于【返回】&【关闭】） 如果为false或未设置，则显示导航栏左侧按钮 如果为true，则隐藏导航栏左侧按钮	注： 仅移动端适用 如果ksoxzHideNavBar为true，此参数将无效。 在deeplink中需拼接在url中并Encode
ksoxzHideNavRriButton	boolean	控制是否隐藏导航栏的右侧功能按钮（包括但不限于【更多操作】&【关闭】） 如果为false或未设置，则显示导航栏右侧按钮 如果为true，则隐藏导航栏右侧按钮	注： 仅移动端适用 如果ksoxzHideNavBar为true，此参数将无效。 在deeplink中需拼接在url中并Encode
ksoxzHideNavMoreButton	boolean	控制是否隐藏导航栏的右侧 【更多操作】操作功能按钮 如果为false或未设置，则显示导航栏【更多操作】按钮 如果为true，则隐藏导航栏【更多操作】按钮	注： 仅移动端适用 如果ksoxzHideNavBar或ksoxzHideNavRriButton为true，此参数将无效。 在deeplink中需拼接在url中并Encode
ksoxzHideNavCloseButton	boolean	控制是否显示导航栏的右侧 【关闭】功能按钮 如果为false或未设置，则显示导航栏【关闭】 按钮如果为true，则隐藏导航栏【关闭】按钮	注： 仅移动端适用 如果ksoxzHideNavBar或ksoxzHideNavRriButton为true，此参数将无效。 在deeplink中需拼接在url中并Encode
mode	string	main_webview： 主窗口模式（4.10.0 及以上版本支持） sidebar：聊天界面右侧 window：独立窗口模式（3.13.0 及以上版本支持）	注：仅PC端适用

注：开发者使用该能力时需注意以下事项，当同一url中业务参数存在重复或对展示/隐藏效果存在冲突时，响应参数优先级规则如下。

• 当以下参数在url中冲突时，优先响应的规则为：ksoxzHideNavBar ＞ ksoxzShowMenuItem&ksoxzHideTitle ＞ ksoxzHideNavRriButton
• 当同一参数在url中多次使用且实现效果是冲突时，优先响应的规则为 true＞false