目录

调用应用内全景展示

调用方式说明

全景服务有应用外全景展示调用和应用内全景展示调用两种用法:

如果您想在自己的应用内以视图控件的形式展示全景图,且能够快速切换全景图与控制方式,此时就需要用应用内全景展示调用的方式来实现。具体实现步骤如下:

  1. 创建本地对象。

    与之相关的接口为:PanoramaLocalInterface getLocalInstance(Context context)

    Name

    Description

    Context

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

    调用示例:

    PanoramaInterface.PanoramaLocalInterface mLocalInstance = Panorama.getInstance().getLocalInstance(this);
  2. 初始化。

    与之相关的接口为:int init()

    调用示例:

    if (mLocalInstance.init() != 0) { 
        // 弹框提示 
        return; 
    }

    此接口会初始化全景服务SDK所需的资源,所以成功初始化是后续接口能正确调用的前提。

  3. 设置素材并指定类型。
    • 图片全景展示。

      与之相关的接口为: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()获取宽高后进行设置。

  4. (可选)设置属性,以极坐标形式展示全景图。

    与之相关的接口为: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之后再设置以极坐标形式展示,否则设置将无法生效。

  5. 设置浏览控制模式。

    与之相关的接口为:void setControlMode(int mode)

    Name

    Description

    mode

    设置全景图浏览的控制方式。

    当前支持的类型有:手机姿态控制、触摸控制或二者同时控制。

    使用触摸控制需要您调用updateTouchEvent。

    调用示例

    // 三种控制模式:CONTROL_TYPE_TOUCH、CONTROL_TYPE_POSE 和 CONTROL_TYPE_MIX
    mLocalInstance.setControlMode(PanoramaInterface.CONTROL_TYPE_POSE);

    该接口支持手机姿态控制、触摸控制以及二者同时控制,共三种浏览控制模式,支持运行过程中实时切换。

  6. 获取视图对象。

    与之相关的接口为:View getView()

    调用示例:

    View view = mLocalInstance.getView(); 
    // 直接展示全景图 
    setContentView(view);

    您可以根据自己的实际需求将获取到的View添加到自己的布局中。

  7. 实时更新触摸事件。

    与之相关的接口为: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; 
        } 
    });
    • updateTouchEvent接口的调用只在开启触摸控制模式时生效。
    • 触摸位置坐标以全景图View控件左上角为原点。
    • 您处理上层App需要的触摸事件,将其余事件转给SDK处理,但需保证传入的触摸事件是正确且符合触摸规律的。
  8. 去初始化。

    与之相关的接口为:void deInit()

    调用示例:

    mLocalInstance.deInit();

    当不再需要使用应用内全景展示服务能力时,须调用该接口来销毁资源,否则会出现资源泄露。

完整调用示例

[h2]图片全景完整调用示例

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();
    }
}

[h2]视频全景完整调用示例

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();
    }
}