API for panorama display in an app.

init()

Initializes an API in an app.

getView()

Obtains the view for displaying a panorama.

setImage(Uri uri, int type)

Sets a panorama and a format.

Surface

getSurface(int type)

Obtains the surface used for video display.

setValue(String name, String value)

Sets attributes.

getValue(String name)

Obtains attribute values.

setControlMode(int mode)

Sets the mode for controlling a panorama when it is viewed.

updateTouchEvent(MotionEvent event)

Updates a touch event, which is valid only in touch mode.

deInit()

Deinitializes the API in the app and destroys the resources.

int init();

Initializes an API in an app.

int

If the operation is successful, value ResultCode.SUCCESS is returned. Otherwise, an error code is returned.

View getView()

Obtains the view for displaying a panorama. You can add the view to your own layout based on the actual requirements.

View

View for rendering a panorama.

int setImage(Uri uri, int type)

Sets a panorama and a format.

uri

URI of the panorama to be loaded.

Three URIs starting with file, content, and android.resourceare supported.

type

Panorama type.

Currently, spherical(IMAGE_TYPE_SPHERICAL) and cylindrical(IMAGE_TYPE_RING) panoramas are supported.

int

If the operation is successful, value ResultCode.SUCCESS is returned. Otherwise, an error code is returned.

Surface getSurface(int type);

Obtains the surface used for video display.

Type of images decoded from video.

Surface that displays video images decoded by the video player.

int setValue(String name, String value)

Sets attributes.

name

Name of the attribute to be set.

value

Value of the attribute to be set

int

If the API is called successfully, ResultCode.SUCCEED is returned. Otherwise, an error code is returned.

String getValue(String name)

Obtains attribute values.

name

Name of the attribute whose value is to be obtained.

String

If the API is called successfully, the attribute value is returned. 

If the API fails to be called or the attribute value cannot be obtained, an empty string is returned.

KEY_RENDER_MODE

Rendering mode.

Current azimuth.

Current horizontal FOV.

void setControlMode(int mode)

Sets the mode for controlling a panorama when it is viewed,which can be dynamically changed.

mode

Sets the mode for controlling a panorama when it is viewed.

Currently, motion tracking control and touch mode are supported.

You need to call updateTouchEvent for the touch mode.

void updateTouchEvent(MotionEvent event)

Updates a touch event, which is valid only in touch mode.

event

Standard touch event of Android. The touch position is calculated by using the upper left corner of the panorama view control as the origin (0,0).

The event can be passed through OnTouchListener of the view.

You can process the touch event required by an upper-layer app and transfer other events tothe SDK for processing.

void deInit()

Deinitializes the API in the app and destroys the resources.

int

If the operation is successful, value ResultCode.SUCCEED is returned. Otherwise, an error code is returned.