如果您想在自己的应用内以视图控件的形式展示全景图,且能够快速切换全景图与控制方式,此时就需要用应用内全景展示调用的方式来实现。具体实现步骤如下:
与之相关的接口为:PanoramaLocalInterface getLocalInstance(Context context)
Name |
Description |
|---|---|
Context |
应用上下文,如果需要主动触发升级,需要传入Activity。 |
调用示例:
PanoramaInterface.PanoramaLocalInterface mLocalInstance = Panorama.getInstance().getLocalInstance(this);
与之相关的接口为:int init()
调用示例:
if (mLocalInstance.init() != 0) { // 弹框提示 return; }
此接口会初始化全景服务SDK所需的资源,所以成功初始化是后续接口能正确调用的前提。
与之相关的接口为:int setImage(Uri uri, int type)
Name |
Description |
|---|---|
uri |
将要加载的全景图URI,支持以file、content及android.resource开头的三类URI。 |
type |
图片类型,当前支持球形全景图(IMAGE_TYPE_SPHERICAL)、环形/柱状全景图(IMAGE_TYPE_RING)。 |
调用示例:
if (mLocalInstance.setImage(uri, PanoramaInterface.IMAGE_TYPE_SPHERICAL) != 0) { // 弹框提示 return; }
与之相关的接口为:Surface getSurface(int type)
Name |
Description |
|---|---|
type |
视频解码后的图片类型。 |
调用示例:
Surface videoSurface = mLocalInstance.getSurface(PanoramaInterface.IMAGE_TYPE_RING);
获取Surface后,需在MediaPlayer中进行设置。
部分示例:
Uri uri = Uri.parse("android.resource://" + getPackageName() + "/" + R.raw.sample);
mPlayer = new MediaPlayer();
try {
// 设置视频源
mPlayer.setDataSource(getApplicationContext(), uri);
} catch (IOException e) {
e.printStackTrace();
return;
}
// 播放器循环播放
mPlayer.setLooping(true);
mPlayer.setAudioStreamType(AudioManager.STREAM_ALARM);
// 设置视频播放输出surface
mPlayer.setSurface(videoSurface);
与之相关的接口为:int setValue(String name, String value)
Name |
Description |
|---|---|
name |
需要设置的属性名称。 |
value |
需要设置的属性值。 |
调用示例:
mLocalInstance.setValue(PanoramaInterface.KEY_VIDEO_RATIO, String.valueOf(mPlayer.getVideoWidth() / mPlayer.getVideoHeight()));
设置视频的宽高比需您保证其正确性,建议在MediaPlayer资源加载prepare后,通过getVideoWidth()、getVideoHeight()获取宽高后进行设置。
与之相关的接口为:int setValue(String name, String value)
Name |
Description |
|---|---|
name |
需要设置的属性名称。 |
value |
需要设置的属性值。 |
调用示例:
int ret = mLocalInstance.setValue(PanoramaInterface.KEY_RENDER_MODE, PanoramaInterface.VALUE_RENDER_MODE_POLAR);
if (ret != ResultCode.SUCCEED) {
// 弹框提示
}
请务必在设置全景图片URI之后再设置以极坐标形式展示,否则设置将无法生效。
与之相关的接口为:void setControlMode(int mode)
Name |
Description |
|---|---|
mode |
设置全景图浏览的控制方式。 当前支持的类型有:手机姿态控制、触摸控制或二者同时控制。 使用触摸控制需要您调用updateTouchEvent。 |
调用示例
// 三种控制模式:CONTROL_TYPE_TOUCH、CONTROL_TYPE_POSE 和 CONTROL_TYPE_MIX mLocalInstance.setControlMode(PanoramaInterface.CONTROL_TYPE_POSE);
该接口支持手机姿态控制、触摸控制以及二者同时控制,共三种浏览控制模式,支持运行过程中实时切换。
与之相关的接口为:View getView()
调用示例:
View view = mLocalInstance.getView(); // 直接展示全景图 setContentView(view);
您可以根据自己的实际需求将获取到的View添加到自己的布局中。
与之相关的接口为:void updateTouchEvent(MotionEvent event)
Name |
Description |
|---|---|
event |
Android标准触摸事件。 |
调用示例:
View view = mLocalInstance.getView();
// 更新触摸事件
view.setOnTouchListener(new View.OnTouchListener() {
@Override
public boolean onTouch(View v, MotionEvent event) {
if (mLocalInstance != null) {
mLocalInstance.updateTouchEvent(event);
}
return true;
}
});
与之相关的接口为:void deInit()
调用示例:
mLocalInstance.deInit();
当不再需要使用应用内全景展示服务能力时,须调用该接口来销毁资源,否则会出现资源泄露。
public class LocalDisplayActivity extends AppCompatActivity implements View.OnClickListener, View.OnTouchListener {
private static final String LOG_TAG = "PanoramaKitDemo";
private PanoramaInterface.PanoramaLocalInterface mLocalInstance;
private ImageButton mImageButton;
private boolean mChangeButtonCompass = false;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.display_err);
final Uri uri = Uri.parse("android.resource://" + getPackageName() + "/" + R.raw.panoramaPic);
// 获取PanoramaLocalInterface实例对象
mLocalInstance = Panorama.getInstance().getLocalInstance(this);
// 判断初始化以及设置图片是否成功
if (mLocalInstance.init() == 0 && mLocalInstance.setImage(uri, PanoramaInterface.IMAGE_TYPE_SPHERICAL) == 0) {
// 获取view,并将其添加到layout
RelativeLayout layout = findViewById(R.id.relativeLayout);
View view = mLocalInstance.getView();
layout.addView(view);
// 将触屏事件更新到SDK
view.setOnTouchListener(this);
// 改变控制方式
mImageButton = findViewById(R.id.changeButton);
mImageButton.bringToFront();
mImageButton.setOnClickListener(this);
} else {
Log.e(LOG_TAG, "local api error");
Toast.makeText(this, "Local init error!", Toast.LENGTH_LONG).show();
}
}
@Override
public void onClick(View v) {
if (v.getId() == R.id.changeButton) {
if (mChangeButtonCompass) {
mImageButton.setImageDrawable(getResources().getDrawable(R.drawable.ic_touch));
mChangeButtonCompass = false;
mLocalInstance.setControlMode(PanoramaInterface.CONTROL_TYPE_TOUCH);
} else {
mImageButton.setImageDrawable(getResources().getDrawable(R.drawable.ic_compass));
mChangeButtonCompass = true;
mLocalInstance.setControlMode(PanoramaInterface.CONTROL_TYPE_POSE);
}
}
}
@Override
public boolean onTouch(View v, MotionEvent event) {
if (mLocalInstance != null) {
mLocalInstance.updateTouchEvent(event);
}
return true;
}
@Override
protected void onDestroy() {
if (mLocalInstance != null) {
mLocalInstance.deInit();
}
super.onDestroy();
}
}
public class LocalDisplayActivity extends AppCompatActivity implements View.OnClickListener, View.OnTouchListener {
private static final String LOG_TAG = "PanoramaKitDemo";
private PanoramaInterface.PanoramaLocalInterface mLocalInstance;
private ImageButton mImageButton;
private boolean mChangeButtonCompass = false;
private MediaPlayer mPlayer;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.display_err);
final Uri uri = Uri.parse("android.resource://" + getPackageName() + "/" + R.raw.panoramaPic);
// 获取PanoramaLocalInterface实例对象
mLocalInstance = Panorama.getInstance().getLocalInstance(this);
// 判断初始化以及设置图片是否成功
if (mLocalInstance.init() == 0) {
Surface videoSurface = mLocalInstance.getSurface(PanoramaInterface.IMAGE_TYPE_SPHERICAL);
if (videoSurface == null) {
Log.e(LOG_TAG, "videoSurface is null");
return;
}
mPlayer = new MediaPlayer();
try {
mPlayer.setDataSource(getApplicationContext(), uri);
} catch (IOException e) {
e.printStackTrace();
return;
}
mPlayer.setLooping(true);
mPlayer.setSurface(videoSurface);
try {
mPlayer.prepare();
} catch (IOException e) {
Log.e(LOG_TAG,"Media Player prepare exception");
}
mPlayer.start();
// 获取view,并将其添加到layout
RelativeLayout layout = findViewById(R.id.relativeLayout);
View view = mLocalInstance.getView();
layout.addView(view);
// 将触屏事件更新到SDK
view.setOnTouchListener(this);
// 改变控制方式
mImageButton = findViewById(R.id.changeButton);
mImageButton.bringToFront();
mImageButton.setOnClickListener(this);
} else {
Log.e(LOG_TAG, "local api error");
Toast.makeText(this, "Local init error!", Toast.LENGTH_LONG).show();
}
}
@Override
public void onClick(View v) {
if (v.getId() == R.id.changeButton) {
if (mChangeButtonCompass) {
mImageButton.setImageDrawable(getResources().getDrawable(R.drawable.ic_touch));
mChangeButtonCompass = false;
mLocalInstance.setControlMode(PanoramaInterface.CONTROL_TYPE_TOUCH);
} else {
mImageButton.setImageDrawable(getResources().getDrawable(R.drawable.ic_compass));
mChangeButtonCompass = true;
mLocalInstance.setControlMode(PanoramaInterface.CONTROL_TYPE_POSE);
}
}
}
@Override
public boolean onTouch(View v, MotionEvent event) {
if (mLocalInstance != null) {
mLocalInstance.updateTouchEvent(event);
}
return true;
}
@Override
protected void onDestroy() {
if (mLocalInstance != null) {
mLocalInstance.deInit();
}
super.onDestroy();
}
}