移动开发平台 mPaaS 10.1.60

By | 2021年4月23日
0 Comment

本文档为您介绍 10.1.60 基线下关于 H5 容器和离线包的 Android SDK 的接口详情。

公共函数

H5TitleView

getTitle

  • 声明
    String getTitle();
  • 说明
    获取主标题文本。
  • 参数
    无
  • 返回值
    String，主标题。

setTitle

  • 声明
    void setTitle(String title);
  • 说明
    设置主标题文本。
  • 参数
参数 类型 说明
title String 标题文本
  • 返回值
    无

setSubTitle

  • 声明
    void setSubTitle(String subTitle);
  • 说明
    设置副标题。
  • 参数
参数 类型 说明
subTitle String 副标题文本
  • 返回值
    无

setImgTitle

  • 声明
    void setImgTitle(Bitmap imgTitle)；
  • 说明
    设置图像图标。
  • 参数
参数 类型 说明
imgTitle Bitmap 图像信息
  • 返回值
    无

setImgTitle

  • 声明
    void setImgTitle(Bitmap imgTitle,String contentDescription);
  • 说明
    设置图像图标和 contentDescription。
  • 参数
参数 类型 说明
imgTitle Bitmap 图像信息
contentDescription String contentDescription 的内容
  • 返回值
    无

showCloseButton

  • 声明
    void showCloseButton(boolean visible);
  • 说明
    是否显示关闭按钮。
  • 参数
参数 类型 说明
visible boolean true，显示关闭按钮；
false，不显示关闭按钮。
  • 返回值
    无

getContentView

  • 声明
    View getContentView()；
  • 说明
    容器获取标题栏 View。
  • 参数
    无
  • 返回值
    View，标题栏 View。

getContentBgView

  • 声明
    ColorDrawable getContentBgView();
  • 说明
    容器获取标题栏背景。
  • 参数
    无
  • 返回值
    ColorDrawable，标题栏背景。

getMainTitleView

  • 声明
    TextView getMainTitleView();
  • 说明
    容器获取主标题 View。
  • 参数
    无
  • 返回值
    TextView，主标题 View。

getSubTitleView

  • 声明
    TextView getSubTitleView();
  • 说明
    容器获取副标题 View。
  • 参数
    无
  • 返回值
    TextView，副标题 View。

showBackButton

  • 声明
    void showBackButton(boolean visible);
  • 说明
    设置是否展示返回按钮。
  • 参数
参数 类型 说明
visible boolean true，显示返回按钮；
false，不显示返回按钮。
  • 返回值
    无

showBackHome

  • 声明
    void showBackHome(boolean visible);
  • 说明
    设置首页按钮可见性。
  • 参数
参数 类型 说明
visible boolean true，显示返回按钮；
false，不显示返回按钮。
  • 返回值
    无

    showOptionMenu

  • 声明
    void showOptionMenu(boolean visible);
  • 说明
    设置是否显示右上角菜单项。
  • 参数
参数 类型 说明
visible boolean true，显示菜单；
false，不显示菜单。
  • 返回值
    无

setOptionType

  • 声明
    void setOptionType(H5Param.OptionType type);
  • 说明
    设置右上角菜单项展示类型。
  • 参数
参数 类型 说明
type H5Param.OptionType 菜单展示类型
  • 返回值
    无

setOptionType

  • 声明
    void setOptionType(H5Param.OptionType type, int num, boolean byIndex);
  • 说明
    设置右上角菜单项展示类型。
  • 参数
参数 类型 说明
type H5Param.OptionType 菜单展示类型
num int 从右往左第几个 icon，从 0 开始。
byIndex boolean 是否只对某个菜单项设置展示类型
  • 返回值
    无

showTitleLoading

  • 声明
    void showTitleLoading(boolean visible);
  • 说明
    设置是否在标题栏上显示加载状态，可自行选择实现方式。
  • 参数
参数 类型 说明
visible boolean 是否在标题栏上显示加载状态
  • 返回值
    无

setBtIcon

  • 声明
    void setBtIcon(Bitmap btIcon, int index);
  • 说明
    设置右上角按钮图标。
  • 参数
参数 类型 说明
btIcon Bitmap 图标
index int 从右往左第几个 icon，从 0 开始。
  • 返回值
    无

setH5Page

  • 声明
    void setH5Page(H5Page h5Page);
  • 说明
    设置容器的 H5 页面。
  • 参数
参数 类型 说明
h5Page H5Page H5 页面
  • 返回值
    无

setOptionMenu

  • 声明
    void setOptionMenu(JSONObject params);
  • 说明
    根据 JS 传递过来的参数设置右上角菜单。
  • 参数
参数 类型 说明
params JSONObject JS 参数
  • 返回值
    无

getDivider

  • 声明
    View getDivider();
  • 说明
    容器获取返回按钮和标题内容之间的分割线，可返回空。
  • 参数
    无
  • 返回值
    View，分割线 View。

getHdividerInTitle

  • 声明
    View getHdividerInTitle();
  • 说明
    容器获取标题栏和 Web 页面间的分割线，不可为空。
  • 参数
    无
  • 返回值
    View，分割线 View。

getPopAnchor

  • 声明
    View getPopAnchor();
  • 说明
    容器获取下拉菜单弹出位置的锚点 View。
  • 参数
    无
  • 返回值
    View，下拉菜单弹出位置的锚点 View。

resetTitleColor

  • 声明
    void resetTitleColor(int color);
  • 说明
    容器重置标题栏背景色。
  • 参数
参数 类型 说明
color int 颜色值
  • 返回值
    无

releaseViewList

  • 声明
    void releaseViewList();
  • 说明
    释放被引用的 View，容器页面销毁时触发此方法。
  • 参数
    无
  • 返回值
    无

openTranslucentStatusBarSupport

  • 声明
    void openTranslucentStatusBarSupport(int color);
  • 说明
    容器设置沉浸式标题栏颜色。
  • 参数
参数 类型 说明
color int 颜色值
  • 返回值
    无

setTitleTxtColor

  • 声明
    void setTitleTxtColor(int color);
  • 说明
    设置标题栏字体颜色。
  • 参数
参数 类型 说明
color int 颜色值
  • 返回值
    无

getOptionMenuContainer

  • 声明
    View getOptionMenuContainer();
  • 说明
    容器获取右上角菜单 View, 必须是 ViewGroup 及子类。
  • 参数
    无
  • 返回值
    View，右上角菜单 View。

getOptionMenuContainer

  • 声明
    View getOptionMenuContainer(int index);
  • 说明
    容器根据位置获取右上角菜单 View，必须是 ViewGroup 及子类。
  • 参数
参数 类型 说明
index int 从右向左 icon 的位置，从 0 开始。
  • 返回值
    View，右上角菜单 View。

setBackgroundAlphaValue

  • 声明
    void setBackgroundAlphaValue(int alpha);
  • 说明
    设置背景透明度。
  • 参数
参数 类型 说明
alpha int 透明度值
  • 返回值
    无

setBackgroundColor

  • 声明
    void setBackgroundColor(int color);
  • 说明
    设置背景色。
  • 参数
参数 类型 说明
color int 背景色的值
  • 返回值
    无

H5AppCenterPresetProvider

getCommonResourceAppList

  • 声明
    Set<String> getCommonResourceAppList();
  • 说明
    获取全局资源包。
  • 参数
    无
  • 返回值
    Set<String>，全局资源包集合。

getH5PresetPkg

  • 声明
    H5PresetPkg getH5PresetPkg();
  • 说明
    获取预置资源包。
  • 参数
    无
  • 返回值
    H5PresetPkg，H5 预置资源包。

getTinyCommonApp

  • 声明
    String getTinyCommonApp();
  • 说明
    获取 tinyApp 的公告资源包的 appId。
  • 参数
    无
  • 返回值
    String，tinyApp 的公告资源包的 appId。

H5Plugin

onPrepare

  • 声明
    void onPrepare(H5EventFilter filter);
  • 说明
    预准备阶段注册 H5 插件过滤器。
  • 参数
参数 类型 说明
filter H5EventFilter H5 插件过滤器
  • 返回值
    无

interceptEvent

  • 声明
    boolean interceptEvent(final H5Event event, final H5BridgeContext context);
  • 说明
    拦截事件。
  • 参数
参数 类型 说明
event H5Event H5 事件
context H5BridgeContext 上下文
  • 返回值
    boolean，若成功返回 true，否则返回 false。

handleEvent

  • 声明
    boolean handleEvent(final H5Event event, final H5BridgeContext context);
  • 说明
    是否发送事件。
  • 参数
参数 类型 说明
event H5Event 可处理的只读事件
context H5BridgeContext 用于处理一些 JSAPI 相关事件的桥接上下文。
  • 返回值
    boolean，true 表示插件已经处理了它，否则返回 false。

H5ReplaceResourceProvider

自定义资源动态加载切点

getReplaceResourcesBundleName

  • 声明
    String getReplaceResourcesBundleName();
  • 说明
    获取标题栏资源的 bundle 名称。
  • 参数
    无
  • 返回值
    String，标题栏资源的 bundle 名称。

H5ErrorPageView

自定义网络错误页接口

enableShowErrorPage

  • 声明
    boolean enableShowErrorPage(H5Page h5Page, APWebView view, String errorUrl, int statusCode, String errorMsg, String subErrorMsg, Bundle extInfo, Object extObj);
  • 说明
    是否展示自定义错误页。
  • 参数
参数 类型 说明
h5Page H5Page Page 对象。
view APWebView WebView 对象。
errorUrl String 错误地址。
statusCode int 错误码。
errorMsg String 错误描述。
subErrorMsg String 错误描述 sub。
extInfo Bundle 扩展信息。
extObj Object 扩展类。
  • 返回值
    boolean，true 表示需要展示自定义页面，会执行 errorPageCallback 方法。

H5BridgeContext

H5 插件返回结果给 Jsapi 请求接口类

sendBridgeResult

  • 声明
    boolean sendBridgeResult(JSONObject data);
  • 说明
    给 js 层返回结果。返回一次事件就被消费掉，如需多次使用一个 BridgeContext 返回，则需调用 sendBridgeResultWithCallbackKept。
  • 参数
参数 类型 说明
data JSONObject 返回给 js 层的数据。
  • 返回值
    boolean，若成功返回 true，否则返回 false。

sendToWeb

  • 声明
    void sendToWeb(String action, JSONObject param, H5CallBack callback);
  • 说明
    给 js 层返回结果，支持添加回调参数。
  • 参数
参数 类型 说明
action String 传递数据时的 action。
param JSONObject 需要传递给 js 层的数据。
callback H5CallBack –
  • 返回值
    无

sendError

  • 声明
    boolean sendError(H5Event event, Error code);
  • 说明
    发送错误信息。
  • 参数
参数 类型 说明
event H5Event H5 事件
code Error 错误信息
  • 返回值
    boolean，true 表示传递成功，否则为 false。

sendSuccess

  • 声明
    void sendSuccess();
  • 说明
    用于无返回值的 H5 回调。
  • 参数
    无
  • 返回值
    无

sendError

  • 声明
    void sendError(int error, String errorMessage);
  • 说明
    自定义返回错误码和返回文案。
  • 参数
参数 类型 说明
error int 返回错误码。
errorMessage String 返回文案。
  • 返回值
    无

回调函数

errorPageCallback

  • 声明
    void errorPageCallback(H5Page h5Page, APWebView view, String errorUrl, int statusCode, String errorMsg, String subErrorMsg, Bundle extInfo, Object extObj)
  • 说明
    错误页回调。
  • 参数
参数 类型 说明
h5Page H5Page Page 对象。
view APWebView WebView 对象。
errorUrl String 错误地址。
statusCode int 错误码。
errorMsg String 错误描述。
subErrorMsg String 错误描述 sub。
extInfo Bundle 扩展信息。
extObj Object 扩展类。
  • 返回值
    无

请关注公众号获取更多资料

发表回复

您的电子邮箱地址不会被公开。 必填项已用*标注