文档中心

安装

环境准备

1.运行环境，iOS12及以上 2.鉴权和认证 要使用百度智能云产品，您需要拥有一个百度智能云账号和一个有效的 AK(Access Key ID)、SK(Secret Access Key)用来进行签名认证。 可以通过如下步骤获得并了解您的AK/SK信息：

• 注册百度智能云账号
• 创建AK/SK

下载和安装

SDK

1. 从此处下载 Phoenix_release_{verison}.tar.gz。（version为具体版本号）
2. 解压
3. 导入Phoenix.xcframework到工程里

Demo

1. 从此处下载Demo。
2. 解压
3. 请求授权接口填入申请的AK，SK。

具体功能

全景：全景图渲染，相机操作，多种交互模式，热点等 环物：环物渲染，手势操作，多种交互模式，热点等

快速入门

本节介绍如何快速使用Phoenix SDK完成常见操作。

请求授权

Phoenix SDK 使用前需要进行初始化，传入申请的 ak sk，依据回调结果进行后续操作。

PhoenixSDK.shared.authorize(ak: "your-access-key-id", sk: "your-secret-access-key", 

complete: { error in if error == nil { print("授权成功") } else { print("授权失败") } })

全景

目前全景图支持四种渲染类型，分别是 cube 散图、cube 雪碧图、单张全景图和分级分块图。

1. 初始化

首先创建 PanoConfiguration:

let config = PanoConfiguration(resource: resourceString)

用户可对配置PanoConfiguration进行设置：

// 是否开启入场动画 config.enableEnterAnimation = false // 初始视角 config.cameraAngle = 0 

// 渲染分级分块图时，设置瓦片图加载延迟 ，默认500ms config.tileUpdateDuration = 0

初始化PanoView：

// 第一种方式 let panoView = PanoView(frame: view.frame, configuration: config) 

// 第二种方式 let panoView = PanoView(frame: view.frame) panoView.updateConfiguration(configuration: config)

1. 添加热点

// 创建自定义热点View let helloHotspot = HelloPanoHotspot() helloHotspot.frame = CGRect

(x: 0, y: 0, width: 42, height: 42) // 初始PanoViewHotspot let hotspot = PanoViewHotsp

ot(view: helloHotspot, x: 0, y: -20, z: -80) //添加到panoView中 panoView?.add(hotspot: hotspot)

1. 删除热点

// 删除热点 panoView?.remove(hotspot: hotspot) // 删除所有热点 panoView?.removeAllHotspots()

1. 动画

// 属性动画 let animation = CABasicAnimation(keyPath: "eulerAngles.y") animation.byV

alue = degreeToRadians(angle: 360) animation.duration = 10 panoView?.camera?.add(ani

mation, forKey: "camera") // 开始自动旋转 （默认10s一圈） panoView?.startAutoRotate(d

uration: 10, isReverse: Bool = false) // 停止自动旋转 panoView?.stopAutoRotate()

环物

1. 初始化

首先创建 SpinConfiguration:

let config = SpinConfiguration(resource: resourceString)

初始化SpinView：

// 第一种方式 let spinView = SpinView(frame: view.frame, configuration: config) //

 第二种方式 let spinView = SpinView(frame: view.frame) panoView.updateConfiguration(configuration: config)

1. 添加热点

// 创建自定义热点View let helloHotspot = HelloPanoHotspot() helloHotspot.frame = CGRect(x: 

0, y: 0, width: 50, height: 50) // 初始PanoViewHotspot let hotspot = SpinHotspot(view: hel

loHotspot, row: 0, column: 0, x: 0.5, y: 0.5) //添加到panoView中 spinView?.add(hotspot: hotspot)

1. 删除热点

// 删除热点 spinView?.remove(hotspot: hotspot) // 删除所有热点 spinView?.removeAllHotspots()

1. 动画

// 属性动画 let columnAnimation = CABasicAnimation(keyPath: SpinAnimationP

roperty.column) columnAnimation.fromValue = 0 columnAnimation.toValue = 18 

columnAnimation.duration = 2 spinView?.add(columnAnimation, forKey: "columnAnimation")

API及参数

全景

PanoView接口列表

PanoView属性列表

PanoCamera接口列表

PanoCamera属性列表

PanoViewDelegate接口列表

环物

SpinView接口列表

SpinView属性列表

SpinViewDelegate接口列表

版本变更记录