全景剪辑使用帮助

SDK

1. 全景剪辑Android SDK v1.0

Android SDK[下载]

得图全景剪辑Android SDK是一套基于Android 2.1及以上版本设备的应用程序接口。 您可以使用该套 SDK开发适用于Android系统移动设备的全景串联应用,通过调用SDK接口,您可以轻 松展示得图全景服务和数据, 构建功能丰富、交互性强的全景展示应用程序。

1.1 开发工具

Android开发工具有很多,开发者可根据自己的喜好进行选择。在此,我们推荐开发者使用Eclipse作为自己的开发工具,本套开发指南也是针对Eclipse开发环境下进行编写的。

1.2 工程配置

第一步:

在工程里新建libs文件夹,解压缩DetuPanoGL.rar,将里面的文件及文件夹拷贝到libs根目录下(官网demo里已有这个文件,如果要集成到自己的工程里,就需要自己添加),拷贝完成后的工程 目录如下图所示;

第二步:

在工程属性->Java Build Path->Libraries中选择“Add External JARs”,选定DetuPanoGL_X.X.jar,确定后返回。

通过以上两步操作后,您就可以正常使用漫游SDK为您提供的全部功能了。

1.3 全景剪辑展示

得图串联SDK为开发者提供了便捷的展示全景串联的接口,通过以下几步操作,即可在您的应用中使用得图全景的图片数据:

第一步:

创建并配置工程(具体方法参见工程配置部分的介绍);

第二步:

在Manifest中添加使用权限及Android版本支持;

常用使用权限如下(开发者可根据自身程序需求,添加所需权限):

<!--使用网络功能所需权限  -->
<uses-permission android:name="android.permission.INTERNET" >
</uses-permission>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" >
</uses-permission>

<!-- SDK本地缓存功能需要读写外部存储器 --> 
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" >
</uses-permission>
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" >
</uses-permission>
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" >
</uses-permission>
<uses-permission android:name="android.permission.ACCESS_MOCK_LOCATION" >
</uses-permission>

配置Activity:

 <activity android:name="com.example.detupanogldemo.MainActivity"  
              android:launchMode="singleInstance"  
              android:screenOrientation="nosensor">  
 </activity>

第三步:

在布局xml文件中添加全景串联控制控件,布局文件保存为activity_main.xml:

<?xml version="1.0" encoding="utf-8"?>  
    <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"  
                android:orientation="vertical"  
                android:layout_width="fill_parent"  
                android:layout_height="fill_parent">

</LinearLayout>

第四步:

创建Activity,并import相关类:

    import com.detupanogl.PLView;
    import com.detupanogl.loaders.PLJSONLoader;

    import android.os.Bundle;
    import android.os.Environment;
    import android.view.Menu;
    import android.view.View;

    public class MainActivity extends PLView {
            @Override  
            public void onCreate(Bundle savedInstanceState){

            }  
    }   
    @Override
    protected View onContentViewCreated(View contentView)
    {           
        return super.onContentViewCreated(contentView);
    }

第五步:

加载全景剪辑:

        @Override  
        public void onCreate(Bundle savedInstanceState){ 
         this.load(new PLJSONLoader("http://sample.img.detuyun.cn/docs/doc/pa/aaaa.xml",true,Environment.getExternalStorageDirectory().getPath().concat("/")));
                    }  
            }

说明:PLJSONLoader构造函数三个参数含义分别为全景串联网址、图片是否缓存到本地、缓存目录。上面代码中的全景串联地址是演示地址,真实的应用过程应该先在得图云网站上注册,再登录并上传全景并且生成全景串联,进而生成全景串联外链地址。[请注册]

完成以上步骤后,运行程序,即可在您的应用中显示如下

以上是最简单的SDK演示程序创建过程,其程序项目[下载]

1.4 有关全景剪辑控制的其他接口

串联名称的显示

全景名称的显示

全景串联缩略图导航

热点触摸事件接口的使用:热点触摸可以触发:文本显示、音频播放、视频播放

包含这些功能的高级演示程序在这里[下载]