RenderView-Class Summary-com.huawei.hms.scene.sdk.render-Android-图形引擎服务

展开

Class Info
public class RenderView extends SurfaceView 渲染视图控件，提供渲染能力。

Class Info

public class RenderView extends SurfaceView

渲染视图控件，提供渲染能力。

Public Constructor Summary

展开

Constructor Name
RenderView(Context context) 简易构造方法。
RenderView(Context context, AttributeSet attrs) Layout XML构造方法。

Constructor Name

RenderView(Context context)

简易构造方法。

RenderView(Context context, AttributeSet attrs)

Layout XML构造方法。

Public Method Summary

展开

Qualifier and Type	Method Name and Description
void	addOnTouchEventListener(RenderView.OnTouchEventListener onTouchEventListener) 添加触摸手势监听器。
void	destroy() 通知RenderView销毁，需要在Activity#onDestroy中调用。该方法必须调用，否则RenderView将无法正常工作。
Scene	getScene() 获取场景实例。
HitTestResult	hitTest(float sx, float sy) 命中测试，输入屏幕坐标，返回命中测试结果。命中测试结果中包含命中渲染件对应的节点。
boolean	onTouchEvent(MotionEvent event) 响应触摸事件时该方法被调用。
void	resume() 通知RenderView继续渲染，需要在Activity#onResume中调用。该方法必须调用，否则RenderView将无法正常工作。
void	pause() 通知RenderView暂停渲染，需要在Activity#onPause中调用。该方法必须调用，否则RenderView将无法正常工作。
void	setBackground(Drawable background) 设置背景。
void	setBackgroundColor(int color) 设置背景颜色。
void	setOutlineColor(Vector4 color) 设置描边高亮的颜色。
void	setOutlineSize(int size) 设置描边高亮的大小。

Protected Method Summary

展开

Qualifier and Type	Method Name and Description
protected boolean	onBeginFrame() 生命周期回调方法，当绘制一帧前被调用，子类可复写该方法。
protected void	onDestroy() 生命周期回调方法，当RenderView#destroy()方法执行后被调用，子类可复写该方法。
protected void	onDrawFrame() 生命周期回调方法，当绘制一帧时被调用，子类可复写该方法。
protected void	onEndFrame() 生命周期回调方法，当结束一帧绘制时被调用，子类可复写该方法。
protected void	onPause() 生命周期回调方法，当RenderView#pause()方法执行后被调用，子类可复写该方法。
protected void	onResume() 生命周期回调方法，当RenderView#resume()方法执行后被调用，子类可复写该方法。
protected void	onSurfaceChanged(SurfaceHolder holder, int format, int width, int height) 生命周期回调方法，当Surface变化时被调用，子类可复写该方法。
protected void	onSurfaceCreated(SurfaceHolder holder) 生命周期回调方法，当Surface创建时被调用，子类可复写该方法。
protected void	onSurfaceDestroyed(SurfaceHolder holder) 生命周期回调方法，当Surface销毁时被调用，子类可复写该方法。

Public Constructors

RenderView(Context context)

展开

Constructor
public RenderView(Context context) 简易构造。

Constructor

public RenderView(Context context)

简易构造。

Parameters

展开

Name	Description
context	Android组件上下文。

RenderView(Context context, AttributeSet attrs)

展开

Constructor
public RenderView(Context context, AttributeSet attrs) Layout XML构造。

Constructor

public RenderView(Context context, AttributeSet attrs)

Layout XML构造。

Parameters

展开

Name	Description
context	Android组件上下文。
attrs	XML属性集。

Public Methods

addOnTouchEventListener

展开

Method
public void addOnTouchEventListener(RenderView.OnTouchEventListener onTouchEventListener) 添加触摸事件监听器。

Method

public void addOnTouchEventListener(RenderView.OnTouchEventListener onTouchEventListener)

添加触摸事件监听器。

Parameters

展开

Name	Description
onTouchEventListener	触摸事件监听器。

destroy

展开

Method
public void destroy() 通知RenderView销毁，需要在Activity#destroy()方法中调用。

Method

public void destroy()

通知RenderView销毁，需要在Activity#destroy()方法中调用。

getScene

展开

Method
public Scene getScene() 获取场景实例。

Method

public Scene getScene()

获取场景实例。

Returns

展开

Type	Description
Scene	场景实例。

hitTest

展开

Method
public HitTestResult hitTest(float sx, float sy) 命中测试，输入屏幕坐标，返回命中测试结果。命中测试结果中包含命中渲染件对应的节点。

Method

public HitTestResult hitTest(float sx, float sy)

命中测试，输入屏幕坐标，返回命中测试结果。命中测试结果中包含命中渲染件对应的节点。

Parameters

展开

Name	Description
sx	屏幕横向坐标，单位：pixel。
sy	屏幕纵向坐标，单位：pixel。

Returns

展开

Type	Description
HitTestResult	命中测试结果。

onTouchEvent

展开

Method
public boolean onTouchEvent(MotionEvent event) 响应触摸事件时该方法被调用。

Method

public boolean onTouchEvent(MotionEvent event)

响应触摸事件时该方法被调用。

Parameters

展开

Name	Description
event	触摸事件。

Returns

展开

Type	Description
boolean	事件是否向下传递。 true：事件向下传递。 false：事件不向下传递。

Type

Description

boolean

事件是否向下传递。

true：事件向下传递。
false：事件不向下传递。

pause

展开

Method
public void pause() 通知RenderView暂停渲染，需要在Activity#pause()方法中调用。

Method

public void pause()

通知RenderView暂停渲染，需要在Activity#pause()方法中调用。

resume

展开

Method
public void resume() 通知RenderView继续渲染，需要在Activity#resume()方法中调用。

Method

public void resume()

通知RenderView继续渲染，需要在Activity#resume()方法中调用。

setBackground

展开

Method
public void setBackground(Drawable background) 设置背景。

Method

public void setBackground(Drawable background)

设置背景。

Parameters

展开

Name	Description
background	Android可绘制对象。

setBackgroundColor

展开

Method
public void setBackgroundColor(int color) 设置背景颜色。

Method

public void setBackgroundColor(int color)

设置背景颜色。

Parameters

展开

Name	Description
color	Android ARGB颜色值。

setOutlineColor

展开

Method
public void setOutlineColor(Vector4 color) 设置描边高亮的颜色。

Method

public void setOutlineColor(Vector4 color)

设置描边高亮的颜色。

Parameters

展开

Name	Description
color	描边高亮的颜色值，RGBA取值范围[0.0f, 1.0f]。

setOutlineSize

展开

Method
public void setOutlineSize(int size) 设置描边高亮的大小。

Method

public void setOutlineSize(int size)

设置描边高亮的大小。

Parameters

展开

Name	Description
size	描边高亮的大小，单位px，取值范围[1, 5]。

Protected Methods

onBeginFrame

展开

Method
protected boolean onBeginFrame() 生命周期回调方法，当开始绘制一帧时被调用，子类可复写该方法。

Method

protected boolean onBeginFrame()

生命周期回调方法，当开始绘制一帧时被调用，子类可复写该方法。

Returns

展开

Type	Description
boolean	true：将不会绘制下一帧。 false：正常绘制下一帧。

onDestroy

展开

Method
protected void onDestroy() 生命周期回调方法，当RenderView#destroy()方法执行后被调用，子类可复写该方法。

Method

protected void onDestroy()

生命周期回调方法，当RenderView#destroy()方法执行后被调用，子类可复写该方法。

onDrawFrame

展开

Method
protected void onDrawFrame() 生命周期回调方法，当绘制一帧时被调用，子类可复写该方法。

Method

protected void onDrawFrame()

生命周期回调方法，当绘制一帧时被调用，子类可复写该方法。

onEndFrame

展开

Method
protected void onEndFrame() 生命周期回调方法，当完成一帧绘制时被调用，子类可复写该方法。

Method

protected void onEndFrame()

生命周期回调方法，当完成一帧绘制时被调用，子类可复写该方法。

onPause

展开

Method
protected void onPause() 生命周期回调方法，当RenderView#pause()方法执行后被调用，子类可复写该方法。

Method

protected void onPause()

生命周期回调方法，当RenderView#pause()方法执行后被调用，子类可复写该方法。

onResume

展开

Method
protected void onResume() 生命周期回调方法，当RenderView#resume()方法执行后被调用，子类可复写该方法。

Method

protected void onResume()

生命周期回调方法，当RenderView#resume()方法执行后被调用，子类可复写该方法。

onSurfaceChanged

展开

Method
protected void onSurfaceChanged(SurfaceHolder holder, int format, int width, int height) 生命周期回调方法，当Surface改变后被调用，子类可复写该方法。

Method

protected void onSurfaceChanged(SurfaceHolder holder, int format, int width, int height)

生命周期回调方法，当Surface改变后被调用，子类可复写该方法。

Parameters

展开

Name	Description
holder	SurfaceHolder实例。
format	Surface格式。
width	Surface宽度，单位pixel。
height	Surface高度，单位pixel。

onSurfaceCreated

展开

Method
protected void onSurfaceCreated(SurfaceHolder holder) 生命周期回调方法，当Surface创建后被调用，子类可复写该方法。

Method

protected void onSurfaceCreated(SurfaceHolder holder)

生命周期回调方法，当Surface创建后被调用，子类可复写该方法。

Parameters

展开

Name	Description
holder	SurfaceHolder实例。

onSurfaceDestroyed

展开

Method
protected void onSurfaceDestroyed(SurfaceHolder holder) 生命周期回调方法，当Surface销毁后被调用，子类可复写该方法。

Method

protected void onSurfaceDestroyed(SurfaceHolder holder)

生命周期回调方法，当Surface销毁后被调用，子类可复写该方法。

Parameters

展开

Name	Description
holder	SurfaceHolder实例。