目录

PanoramaInterface

Interface Info

public interface PanoramaInterface

提供了浏览全景图的基本方法。

Nested Interface Summary

Qualifier and Type

Interface Name and Description

public interface

PanoramaLocalInterface

提供了应用内全景图展示的接口。

Nested Class Summary

Qualifier and Type

Class Name and Description

public abstract static class

ImageInfoResult

全景图加载结果类。

Public Field Summary

Qualifier and Type

Field and Description

int

IMAGE_TYPE_SPHERICAL

球形全景图。

int

IMAGE_TYPE_RING

环形/柱状全景图。

int

CONTROL_TYPE_TOUCH

触摸控制。

int

CONTROL_TYPE_POSE

手机姿态控制。

int

CONTROL_TYPE_MIX

触摸与手机姿态共同控制。

String

KEY_RENDER_MODE

渲染模式属性名称。

String

VALUE_RENDER_MODE_NORMAL

默认的渲染模式。

String

VALUE_RENDER_MODE_POLAR

极坐标模式渲染。

String

VALUE_RENDER_MODE_ASTEROID

小行星渲染模式。

String

KEY_CURRENT_AZIMUTH

当前方位角。

String

KEY_CURRENT_HORIZONTAL_FOV

当前水平方向视场角。

String

KEY_IMAGE_TYPE

图片类型,分为球形图和环形图,对应的属性值为IMAGE_TYPE_SPHERICAL和IMAGE_TYPE_RING。

String

KEY_VIDEO_RATIO

视频宽高比,原始类型为float,默认值为2:1(即2.0f),该属性的设置只在视频内容为环形时生效,如果播放环形视频时不设置宽高比则以默认值显示,此时若真实宽高比大于2:1则水平方向的图像会被压缩,若小于2:1则会出现水平方向被拉伸。

String

KEY_BITMAP_RECYCLE

位图回收开关。

String

VALUE_TRUE

表示true的字符串。

String

VALUE_FALSE

表示false的字符串。

Public Method Summary

Qualifier and Type

Method Name and Description

PendingResult<PanoramaInterface.ImageInfoResult>

loadImageInfo(Context context, Uri uri)

加载全景图信息,并返回用于跳转到全景Activity的Intent。

PendingResult<PanoramaInterface.ImageInfoResult>

loadImageInfoWithPermission(Context context, Uri uri)

加载全景图信息,并返回用于跳转到全景Activity的Intent,该Intent带有对图片的临时访问授权标记:FLAG_GRANT_READ_URI_PERMISSION,可让全景服务临时访问URI。

PendingResult<PanoramaInterface.ImageInfoResult>

loadImageInfo(Context context, Uri uri, int type)

加载指定类型的全景图信息,并返回用于跳转到全景Activity的Intent。

PendingResult<PanoramaInterface.ImageInfoResult>

loadImageInfoWithPermission(Context context, Uri uri, int type)

加载指定类型的全景图信息,并返回用于跳转到全景Activity的Intent,该Intent带有对图片的临时访问授权标记:FLAG_GRANT_READ_URI_PERMISSION,可让全景服务临时访问URI。

PanoramaInterface.PanoramaLocalInterface

getLocalInstance(Context context)

获取可调用本地API的实例。

Public Fields

[h2]IMAGE_TYPE_SPHERICAL

Field

int IMAGE_TYPE_SPHERICAL

球形全景图。

另请参阅:Constant-values。

[h2]IMAGE_TYPE_RING

Field

int IMAGE_TYPE_RING

环形/柱状全景图。

另请参阅:Constant-values。

[h2]CONTROL_TYPE_TOUCH

Field

int CONTROL_TYPE_TOUCH

触摸控制。

另请参阅:Constant-values。

[h2]CONTROL_TYPE_POSE

Field

int CONTROL_TYPE_POSE

手机姿态控制。

另请参阅:Constant-values。

[h2]CONTROL_TYPE_MIX

Field

int CONTROL_TYPE_MIX

触摸与手机姿态共同控制。

另请参阅:Constant-values。

[h2]KEY_RENDER_MODE

Field

String KEY_RENDER_MODE

渲染模式属性名称,该属性必须在正确设置全景图片后才能设置成功。

另请参阅:Constant-values。

[h2]VALUE_RENDER_MODE_NORMAL

Field

String VALUE_RENDER_MODE_NORMAL

渲染模式属性值,表示默认的渲染模式。

另请参阅:Constant-values。

[h2]VALUE_RENDER_MODE_POLAR

Field

String VALUE_RENDER_MODE_POLAR

渲染模式属性值,表示以极坐标模式渲染全景图。该模式只支持IMAGE_TYPE_SPHERICAL类型的全景图。

另请参阅:Constant-values。

[h2]VALUE_RENDER_MODE_ASTEROID

Field

String VALUE_RENDER_MODE_ASTEROID

渲染模式属性值:表示小行星模式渲染全景图。该模式只支持IMAGE_TYPE_SPHERICAL类型的全景图。

另请参阅:Constant-values。

[h2]KEY_CURRENT_AZIMUTH

Field

String KEY_CURRENT_AZIMUTH

当前方位角。该属性只能被获取,不支持被设置。

另请参阅:Constant-values。

[h2]KEY_CURRENT_HORIZONTAL_FOV

Field

String KEY_CURRENT_HORIZONTAL_FOV

当前水平方向视场角。该属性只能被获取,不支持被设置。

另请参阅:Constant-values。

[h2]KEY_IMAGE_TYPE

Field

String KEY_IMAGE_TYPE

图片类型,分为球形图和环形图,对应的属性值为IMAGE_TYPE_SPHERICAL和IMAGE_TYPE_RING。

另请参阅:Constant-values。

[h2]KEY_VIDEO_RATIO

Field

String KEY_VIDEO_RATIO

视频宽高比,原始类型为float,默认值为2:1(即2.0f),该属性的设置只在视频内容为环形时生效,如果播放环形视频时不设置宽高比则以默认值显示,此时若真实宽高比大于2:1则水平方向的图像会被压缩,若小于2:1则会出现水平方向被拉伸。

另请参阅:Constant-values。

[h2]KEY_BITMAP_RECYCLE

Field

String KEY_BITMAP_RECYCLE

位图回收开关,通过setValue设置为VALUE_TRUE时,表示通过setImage设置的位图在被加载成纹理后,会被回收,设置为VALUE_FALSE时,该位图不会被回收,需要调用者根据实际情况进行释放回收。默认状况请参见setImage。注:该属性须在setImage前调用才能生效。

另请参阅:Constant-values。

[h2]VALUE_TRUE

Field

String VALUE_TRUE

表示true的字符串。

另请参阅:Constant-values。

[h2]VALUE_FALSE

Field

String VALUE_FALSE

表示false的字符串。

另请参阅:Constant-values。

Public Methods

[h2]loadImageInfo(Context context, Uri uri)

Method

PendingResult<PanoramaInterface.ImageInfoResult> loadImageInfo(Context context, Uri uri)

加载全景图信息,并返回用于跳转到全景Activity的Intent。

Parameters

Name

Description

context

应用上下文,如果需要主动触发升级,需要传入Activity。

uri

将要加载的全景图URI,支持以file、content及android.resource开头的三类URI。

Returns

Type

Description

PendingResult<PanoramaInterface.ImageInfoResult>

返回经过PendingResult封装过的ImageInfoResult对象,PendingResult提供了同步获取和异步获取执行结果的方法。

[h2]loadImageInfoWithPermission(Context context, Uri uri)

Method

PendingResult<PanoramaInterface.ImageInfoResult> loadImageInfoWithPermission(Context context, Uri uri)

加载全景图信息,并返回用于跳转到全景Activity的Intent,该Intent带有对图片的临时访问授权标记:FLAG_GRANT_READ_URI_PERMISSION,可让全景服务临时访问URI。

Parameters

Name

Description

context

应用上下文,如果需要主动触发升级,需要传入Activity。

uri

将要加载的全景图URI,支持以file、content及android.resource开头的三类URI。

Returns

Type

Description

PendingResult<PanoramaInterface.ImageInfoResult>

返回经过PendingResult封装过的ImageInfoResult对象,PendingResult提供了同步获取和异步获取执行结果的方法。

[h2]loadImageInfo(Context context, Uri uri, int type)

Method

PendingResult<PanoramaInterface.ImageInfoResult> loadImageInfo(Context context, Uri uri, int type)

加载指定类型的全景图信息,并返回用于跳转到全景Activity的Intent。

Parameters

Name

Description

context

应用上下文,如果需要主动触发升级,需要传入Activity。

uri

将要加载的全景图URI,支持以file、content及android.resource开头的三类URI。

type

图片类型,当前支持球形全景图(IMAGE_TYPE_SPHERICAL)、环形/柱状全景图(IMAGE_TYPE_RING)。

Returns

Type

Description

PendingResult<PanoramaInterface.ImageInfoResult>

返回经过PendingResult封装过的ImageInfoResult对象,PendingResult提供了同步获取和异步获取执行结果的方法。

[h2]loadImageInfoWithPermission(Context context, Uri uri, int type)

Method

PendingResult<PanoramaInterface.ImageInfoResult> loadImageInfoWithPermission(Context context, Uri uri, int type)

加载全景图信息,并返回用于跳转到全景Activity的Intent,该Intent带有对图片的临时访问授权标记:FLAG_GRANT_READ_URI_PERMISSION,可让全景服务临时访问URI。

Parameters

Name

Description

context

应用上下文,如果需要主动触发升级,需要传入Activity。

uri

将要加载的全景图URI,支持以file、content及android.resource开头的三类URI。

type

图片类型,当前支持球形全景图(IMAGE_TYPE_SPHERICAL)、环形/柱状全景图(IMAGE_TYPE_RING)。

Returns

Type

Description

PendingResult<PanoramaInterface.ImageInfoResult>

返回经过PendingResult封装过的ImageInfoResult对象,PendingResult提供了同步获取和异步获取执行结果的方法。

[h2]getLocalInstance

Method

PanoramaInterface.PanoramaLocalInterface getLocalInstance(Context context)

获取应用内展示接口的对象,通过该接口获取的对象非单例。

Parameters

Name

Description

context

应用上下文,如果需要主动触发升级,需要传入Activity。

Returns

Type

Description

PanoramaInterface.PanoramaLocalInterface

调用成功返回可调用PanoramaLocalInterface的对象,调用失败返回null。