Return	Method
int	init() 初始化应用内接口。
View	getView() 获取展示全景图的View。
int	setImage(Uri uri, int type) 设置全景图的图片并指定格式。
Surface	getSurface(int type) 获取用于视频显示的surface。
int	setValue(String name, String value) 设置属性值。
String	getValue(String name) 获取属性值。
void	setControlMode(int mode) 设置全景图浏览的控制方式。
void	updateTouchEvent(MotionEvent event) 更新触摸事件，只在触摸模式下有效。
void	deInit() 反初始化应用内接口并销毁资源。

3. Public Methods

3.1 init

展开

Method
int init() 初始化应用内接口。

Return

Type	Description
int	成功返回ResultCode.SUCCEED，失败返回错误码。

3.2 getView

展开

Method
View getView() 从服务端获取展示全景图的视图对象，开发者可根据自己的实际情况将该视图添加到自己的布局中。

Return

Type	Description
View	用于渲染全景图的View。

3.3 setImage

展开

Method
int setImage(Uri uri, int type) 设置全景图的图片并指定格式。

Parameters

Parameter	Description
uri	将要加载的全景图URI，支持以file、content及android.resource开头的三类Uri。
type	图片类型，当前支持球形全景图（IMAGE_TYPE_SPHERICAL）、环形（柱状）全景图（IMAGE_TYPE_RING）。

Return

Type	Description
int	成功返回ResultCode.SUCCEED，失败返回错误码。

3.4 getSurface

展开

Method
Surface getSurface(int type) 获取用于视频显示的surface。

Parameters

展开

Parameter	Description
type	视频解码后的图片类型

Return

展开

Type	Description
Surface	视频播放器可解码到该surface用于全景展示

3.5 setValue

展开

Method
String setValue(String name) 获取属性值。

Parameters

Parameter	Description
name	需要设置的属性名称。
value	需要设置的属性值。

Return

Type	Description
int	成功返回ResultCode.SUCCEED，失败返回错误码。

3.6 getValue

展开

Method
String getValue(String name) 获取属性值。

Parameters

Parameter	Description
name	需要获取的属性名称。

Return

Type	Description
String	调用正确时返回属性值，调用错误或者不支持该属性的获取时返回空字符串。

注：

当前版本支持获取的属性名称

Parameter	Description
KEY_RENDER_MODE	渲染模式
KEY_CURRENT_AZIMUTH	当前方位角
KEY_CURRENT_HORIZONTAL_FOV	当前水平方向视场角

3.7 setControlMode

展开

Method
void setControlMode(int mode) 设置全景图浏览的控制方式，支持使用过程中动态切换。

Parameters

Parameter	Description
mode	设置全景图浏览的控制方式。当前支持的类型有：手机姿态控制和触摸控制，其中触摸控制需要开发者调用updateTouchEvent。

3.8 updateTouchEvent

展开

Method
void updateTouchEvent(MotionEvent event) 更新视图触摸事件，在开启触屏控制模式的情况下，全景服务将根据触屏事件动态调整视图显示内容。

Parameters

Parameter	Description
event	Android标准触摸事件，触摸位置以全景图View控件左上角为原点，可通过View的OnTouchListener传入。开发者可处理掉上层APP需要的触摸事件，将其余事件转给SDK处理。

Parameter

Description

event

Android标准触摸事件，触摸位置以全景图View控件左上角为原点，可通过View的OnTouchListener传入。

开发者可处理掉上层APP需要的触摸事件，将其余事件转给SDK处理。

3.9 deInit

展开

Method
void deInit() 反初始化应用内接口并销毁资源。

Return

Type	Description
int	成功返回ResultCode.SUCCEED，失败返回错误码。

PanoramaInterface

ImageInfoResult

本页面可能包含由第三方许可的内容，请参考具体描述。