com.uzmap.pkg.openapi

类 ExternalActivity

java.lang.Object

Activity

com.uzmap.pkg.openapi.ExternalActivity

public class ExternalActivity
extends Activity

SuperWebview窗口系统中Activity级别的UI组件类，该类继承自系统Activity。 您项目中任何使用SuperWebview能力的Activity必须继承自该Activity。

通过startActivity调用该类的子类时，可通过Intent传入一个startUrl，SuperWebview将自动加载该URL。 不传递startUrl的情况下，默认走自动加载widget的机制，SuperWebview会自动去解析assets/widget目录下的资源并加载。

如何使用startUrl：

 Intent intent = new Intent(this, ExternalActivitySub.class);
 //String url = "file:///android_asset/widget/index.html";
 String url = "file://" + UZUtility.getExternaStoragePath() + "index.html"; 
 intent.putExtra("startUrl", url);
 Context.startActivity(intent);
 

注意：

"startUrl"必须是本地带标准"file://"或者远程"http://"协议头的可访问资源地址。
例如:
1、位于assets下的资源：file:///android_asset/anyPath/any.html
2、位于SD卡下的资源："file://" + UZUtility.getExternaStoragePath() + "anyPath" + "any.html";
3、位于沙箱下的资源："file://" + sandboxPath + "anyPath" + "any.html";

方法概要

方法

限定符和类型	方法和说明
void	addHtml5EventListener(Html5EventListener listener) 添加一个Html5事件监听器，监听来自Html5页面广播出来的事件。
void	evaluateJavascript(java.lang.String script) 向设备屏幕上当前Window所在的Html5页面执行一段Javascript脚本
void	evaluateJavascript(java.lang.String winName, java.lang.String script) 向SuperWebview窗口系统中，名为winName的window所在的Html5页面执行一段Javascript脚本
void	evaluateJavascript(java.lang.String winName, java.lang.String frameName, java.lang.String script) 向SuperWebview窗口系统中，winName的window下名为frameName的Frame所在的Html5页面执行一段Javascript脚本
protected boolean	onHtml5AccessRequest(WebViewProvider provider, UZModuleContext moduleContext) 收到来自Html5页面对Java的访问请求，该请求保持一个Html5页面的JS回调函数引用，处理完毕后，可直接异步回调到Html5中，与api.accessNative对应
protected void	onPageFinished(WebViewProvider provider, java.lang.String url) 当SuperWebview内部任意Html5页面加载结束时，将通过该函数通知出来。
protected void	onPageStarted(WebViewProvider provider, java.lang.String url, Bitmap favicon) 当SuperWebview内部任意Html5页面开始加载时，将通过该函数通知出来。
protected void	onProgressChanged(WebViewProvider provider, int newProgress) 当SuperWebview内部任意Html5页面加载进度发生变化时，将通过该函数通知出来。
protected void	onReceivedTitle(WebViewProvider provider, java.lang.String title) 当SuperWebview内部任意Html5页面的Title发生变化时，将通过该函数通知出来。
protected boolean	onSmartUpdateFinish(IncPackage iPackage) 云修复静默修复完成时的通知
void	removeAllHtml5EventListener() 移除所有Html5事件监听器
void	removeHtml5EventListener(Html5EventListener listener) 移除某个Html5事件监听器
void	sendEventToHtml5(java.lang.String eventName, JSONObject extra) 发送一个事件给Html5页面。
protected boolean	shouldForbiddenAccess(java.lang.String host, java.lang.String module, java.lang.String api) 当SuperWebview内部Html页面即将访问某个端API时，将通过该接口通知应用，应用可以决定是否拦截，并控制允许或者拒绝访问。
protected boolean	shouldOverrideUrlLoading(WebViewProvider provider, java.lang.String url) 当SuperWebview内部即将请求加载一个url时，将通过该接口通知应用，如果应用拦截并自行处理，引擎将不再处理该请求。

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

方法详细资料

evaluateJavascript

public final void evaluateJavascript(java.lang.String script)

向设备屏幕上当前Window所在的Html5页面执行一段Javascript脚本

参数:

script - Javascript脚本内容。例如：window.alert('hello!');

evaluateJavascript

public final void evaluateJavascript(java.lang.String winName,
                      java.lang.String script)

向SuperWebview窗口系统中，名为winName的window所在的Html5页面执行一段Javascript脚本

参数:

winName - 目标Window的名称 ，传入空时默认为当前屏幕上的Window。该名称来自Html5页面中调用api.openWin接口时传入。

script - Javascript脚本内容。例如：window.alert('hello!');

evaluateJavascript

public final void evaluateJavascript(java.lang.String winName,
                      java.lang.String frameName,
                      java.lang.String script)

向SuperWebview窗口系统中，winName的window下名为frameName的Frame所在的Html5页面执行一段Javascript脚本

参数:

winName - 目标window的名称 ，传入空时默认为当前屏幕上的Window。该名称来自Html5页面中调用api.openWin接口时传入

frameName - 目标Frame的名称 。该名称来自Html5页面中调用api.openFrame接口时传入

script - Javascript脚本内容。例如：window.alert('hello!');

addHtml5EventListener

public final void addHtml5EventListener(Html5EventListener listener)

添加一个Html5事件监听器，监听来自Html5页面广播出来的事件。该接口与端API{api.sendEvent}配合使用

参数:

listener - 见Html5EventListener

removeHtml5EventListener

public final void removeHtml5EventListener(Html5EventListener listener)

移除某个Html5事件监听器

参数:

listener -

removeAllHtml5EventListener

public final void removeAllHtml5EventListener()

移除所有Html5事件监听器

sendEventToHtml5

public final void sendEventToHtml5(java.lang.String eventName,
                    JSONObject extra)

发送一个事件给Html5页面。Html5页面中可通过端API{api.addEventListener}接收该事件

参数:

eventName - 事件名称，任意字符串

extra - 发送给Html5页面的数据

onProgressChanged

protected void onProgressChanged(WebViewProvider provider,
                     int newProgress)

当SuperWebview内部任意Html5页面加载进度发生变化时，将通过该函数通知出来。

参数:

provider - 进度发生变化所在Webview的代理类

newProgress - 新的进度

onReceivedTitle

protected void onReceivedTitle(WebViewProvider provider,
                   java.lang.String title)

当SuperWebview内部任意Html5页面的Title发生变化时，将通过该函数通知出来。

参数:

provider - 进度发生变化所在Webview的代理类

title - 新的标题，即Html5页面的title标签所在的值

onPageStarted

protected void onPageStarted(WebViewProvider provider,
                 java.lang.String url,
                 Bitmap favicon)

当SuperWebview内部任意Html5页面开始加载时，将通过该函数通知出来。

参数:

provider - 进度发生变化所在Webview的代理类

url - 开始加载的url

favicon - 页面对应的小图标，可能为null

onPageFinished

protected void onPageFinished(WebViewProvider provider,
                  java.lang.String url)

当SuperWebview内部任意Html5页面加载结束时，将通过该函数通知出来。

参数:

provider - 进度发生变化所在Webview的代理类

url - 结束加载的url

shouldOverrideUrlLoading

protected boolean shouldOverrideUrlLoading(WebViewProvider provider,
                               java.lang.String url)

当SuperWebview内部即将请求加载一个url时，将通过该接口通知应用，如果应用拦截并自行处理，引擎将不再处理该请求。默认为不拦截

参数:

provider - 进度发生变化所在Webview的代理类

url - 即将请求加载的url

返回:

是否拦截处理

shouldForbiddenAccess

protected boolean shouldForbiddenAccess(java.lang.String host,
                            java.lang.String module,
                            java.lang.String api)

当SuperWebview内部Html页面即将访问某个端API时，将通过该接口通知应用，应用可以决定是否拦截，并控制允许或者拒绝访问。默认为不拦截

参数:

host - Html页面所在的url

module - 即将请求调用的模块

api - 即将请求调用的API

返回:

是否拒绝访问

onHtml5AccessRequest

protected boolean onHtml5AccessRequest(WebViewProvider provider,
                           UZModuleContext moduleContext)

收到来自Html5页面对Java的访问请求，该请求保持一个Html5页面的JS回调函数引用，处理完毕后，可直接异步回调到Html5中，与api.accessNative对应

参数:

provider - 发起该访问请求所在Webview的代理类

moduleContext - Javascript与Java之间交互时的上下文，见UZModuleContext，处理完毕后可通过UZModuleContext.success回调Html5

返回:

是否处理

onSmartUpdateFinish

protected boolean onSmartUpdateFinish(IncPackage iPackage)

云修复静默修复完成时的通知

参数:

iPackage - 修复包信息

返回:

是否处理