10.1.60 基线

本文档为您介绍 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

    扩展类

  • 返回值:无。