圆周率全景相机AndroidSDK使用指南

PISOFTTECH

圆周率全景相机Android SDK使用指南

版本:V1.1.2.Basic

Pisofttech

本文主要指导用户如何将本公司的Android SDK集成到自己的Android项目中，及提供API 说明

目录

一、名词解释 (2)

二、功能介绍 (4)

1.功能列表 (4)

2.使用限制 (4)

三、Android studio如何导入SDK (4)

1.SDK文件结构 (4)

2.导入必要文件 (5)

3.工程配置 (7)

四、SDK初始化 (9)

五、基本功能 (11)

1.如何开始预览 (11)

2.如何查看本地照片 (11)

3.如何播放视频 (12)

六、API说明 (12)

初始化 (12)

PiPanoSDK(Activity actvty, OnSDKIsReadyListener listener) (12)

View getPlayerView() (12)

实时预览 (13)

void setPreviewIsReadyListener(OnPreviewIsReadyListener listener) (13)

int startPreview(String inputSrcType) (13)

int stopPreview() (13)

void setPreviewTextureSize(int width, int height) (14)

SurfaceTexture getPreviewSurfaceTexture() (14)

视频文件播放 (14)

int openVideo(String url, String inputSrcType) (14)

void pause() (14)

void Resume() (15)

void stop() (15)

double getVideoProgress() (15)

void seek(double offset) (15)

查看本地照片 (16)

int openPhoto(String path, String inputSrcType) (16)

显示效果 (16)

int setViewMode(String showMode) (16)

void setImageFlipHorizontal(boolean flag) (17)

void setInputImageContentSize(int canvasWidth, int canvasHeight, int contentWidth, int

contentHeight) (17)

其他 (18)

String getVersion() (18)

void setScreenOrientation(int mode) (18)

String getCurrentInputSrcType() (18)

void setCamDirection(int type) (19)

七、附录....................................................................................................错误!未定义书签。

类PiSourceModeType (19)

方法概要 (19)

类PiViewModeType (19)

方法概要 (20)

类PiTransitionEffectType (20)

方法概要 (20)

类PiCameraDirectionType (20)

八、常见问题 (21)

预览、浏览照片或播放视频文件时，看到的图像是左右相反的 (21)

一个SDK实例可以和多个fragment的Layout绑定吗？ (21)

单鱼眼的输入源，在【沉浸】图像显示不正常怎么办？ (21)

单鱼眼的输入图像画布四边不是和鱼眼图像相切的，怎么才能正常展开？ (21)

一、名词解释

展开：按照特定的3D模型对输入图像进行展示，而这些特定的3D模型称为【展开模式】。

转场动画：从一个展开模式切换到另一个展开模式时的动态过度效果。输入源：根据输入图像内容进行的分类。

预览：实时显示输入的图像数据。

镜头朝向：专指单鱼眼镜头的摆放位置。

二、功能介绍

1.功能列表

2.使用限制

软件要求：

只支持android 5.0及以上armeabi-v7a版本的android应用开发。

硬件要求：

要求CPU 四核2.7GHz ，运行时内存2GB同等及以上性能的手机。

三、Android studio如何导入SDK

1.SDK文件结构

pi_camera_解压后会得到libs、assets、jniLibs、demo、doc三个文件夹，如下图：

其中:

libs、assets及jniLibs文件夹包含的是android工程集成SDK的必须文件;

demo包含的是android studio调用SDK的实例工程;

doc包含的是SDK的帮助文档。

2.导入必要文件

1) 将libs目录下的所有文件复制到android studio工程的libs目录中，如下图：

图中文件仅供参考，实际文件会根据使用前版本有所差异。

2) 将assets文件夹复制到android studio工程的src/main目录中，如下图：