1. 调用方式说明

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

• 应用外全景展示调用是指通过全景SDK的API获取一个Intent，然后跳转至全景服务中的Activity进行全景图的浏览。该调用方式全景服务会在调用该服务的应用外新建一个窗口进行全景信息展示，与之有关的接口为loadImageInfo 和loadImageInfoWithPermission 。

• 应用内全景展示调用是指应用在自己进程内，通过全景SDK的API进行全景图的浏览。该方式更为灵活，全景服务相当于返回一个全景图层，调用该服务的应用可以灵活确定这个图层的展示位置以及在图层上叠加其他图层信息，如广告信息。与之有关的接口为getLocalInstance 及PanoramaLocalInterface 中包含的接口。

2. 应用外全景展示调用

使用应用外全景展示调用时，需要先从全景服务获取用于跳转到全景Activity的Intent，然后通过startActivity传入此Intent，并完成跳转来展示全景图。详细步骤如下：

将全景图的Uri作为输入参数，随后获取可跳转到全景展示Activity的Intent，并完成跳转。

与之相关的接口为：

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

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

获取Intent的方法分为同步调用和异步调用，示例代码如下：

• 同步调用示例

new Thread(new Runnable() {
    @Override
    public void run() {
        PanoramaInterface.ImageInfoResult panoramaResult = Panorama.getInstance().loadImageInfo(MainActivity.this, uri).await();
        if (panoramaResult == null) {
            Log.e(LOG_TAG, "ImageInfoResult is null");
            return;
        }
        if (panoramaResult.getStatus().isSuccess()) {
            Intent intent = panoramaResult.getImageDisplayIntent();
            if (intent != null) {
                 startActivity(intent);
            }
        } else {
             Log.e(LOG_TAG, "error: " + panoramaResult); 
        }
    }
}).start();

• 异步调用示例

Panorama.getInstance().loadImageInfo(this, uri).setResultCallback(
    new ResultCallback<PanoramaInterface.ImageInfoResult>() {
        @Override
        public void onResult(PanoramaInterface.ImageInfoResult panoramaResult) {
            if (panoramaResult == null) {
                Log.e(LOG_TAG, "ImageInfoResult is null");
                return;
            }
            if (panoramaResult.getStatus().isSuccess()) {
                Intent intent = panoramaResult.getImageDisplayIntent();
                if (intent != null) {
                    startActivity(intent);
                }
            } else {
                Log.e(LOG_TAG, "error: " + panoramaResult);
            }
        }
    });

3. 未包含图元信息的全景展示

某些全景图没有元数据信息，但是开发者需要展示该全景图，那么就必须强制指定全景图类型，与之相关的接口为：

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

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

上述接口获取跳转Intent的方式与loadImageInfo完全相同，示例代码如下：

• 同步调用示例

new Thread(new Runnable() {
    @Override
    public void run() {
        PanoramaInterface.ImageInfoResult panoramaResult = Panorama.getInstance().loadImageInfo(MainActivity.this, uri, PanoramaInterface.IMAGE_TYPE_SPHERICAL).await();
        if (panoramaResult == null) {
            Log.e(LOG_TAG, "ImageInfoResult is null");
            return;
        }
        if (panoramaResult.getStatus().isSuccess()) {
            Intent intent = panoramaResult.getImageDisplayIntent();
            if (intent != null) {
                startActivity(intent);
            }
        } else {
            Log.e(LOG_TAG, "error: " + panoramaResult);
        }
    }
}).start();

• 异步调用示例

Panorama.getInstance().loadImageInfo(this, uri,  PanoramaInterface.IMAGE_TYPE_SPHERICAL).setResultCallback(
    new ResultCallback<PanoramaInterface.ImageInfoResult>() {
        @Override
        public void onResult(PanoramaInterface.ImageInfoResult panoramaResult) {
            if (panoramaResult == null) {
                Log.e(LOG_TAG, "ImageInfoResult is null");
                return;
            }
            if (panoramaResult.getStatus().isSuccess()) {
                Intent intent = panoramaResult.getImageDisplayIntent();
                if (intent != null) {
                    startActivity(intent);
                }
            } else {
                Log.e(LOG_TAG, "error: " + panoramaResult);
            }
        }
    });