Poly
Poly
是一个非官方的Google Poly SDK,用Swift
语言编写。
这个库简化了Google Poly的集成,并提供了一些额外的客户端功能。
特性 | |
---|---|
3D模型搜索 | |
3D模型下载管理 | |
高级3D数据缓存 | |
Poly可达性支持 | |
Swift 5.0 |
需要不同版本的Swift?
5.0
- 将Podfile的目标设置为最新发布版或master(Cache更新时将推送到Pod)4.2
- 将Podfile的目标设置为swift4.2
分支
重要
在开始之前,请确保您已阅读Google的Poly 文档,了解归属的最好实践,并已生成您的API密钥。
快速开始
示例项目提供了多个集成示例。
您可以使用pod install
命令或运行makefile命令make setup && make pods
来安装依赖项。
# CocoaPods
pod "Poly", "~> 0.4.0"
# Carthage
github "piemonte/Poly" ~> 0.4.0
# Swift PM
let package = Package(
dependencies: [
.Package(url: "https://github.com/piemonte/Poly", majorVersion: 0)
]
)
或者,将源代码文件拖入您的Xcode项目。
示例
导入库。
import Poly
设置API密钥。
Poly.shared.apiKey = "REPLACE_WITH_API_KEY"
使用关键词列出资产。
Poly.shared.list(assetsWithKeywords: ["fox"]) { (assets, totalCount, nextPage, error) in
// assets array provides objects with information such as URLs for thumbnail images
}
// you may also query for the data directly for your own model creation
Poly.shared.list(assetsWithKeywords: ["fox", "cat"]) { (data, error) in
}
获取独立资产信息。
Poly.shared.get(assetWithIdentifier: "10u8FYPC5Br") { (asset, count, page, error) in
// asset object provides information such as URLs for thumbnail images
}
// you may also query for the data directly for your own model creation
Poly.shared.get(assetWithIdentifier: "10u8FYPC5Br") { (data, error) in
}
下载3D资产及其渲染资源,可以使用资产标识符或资产模型对象本身。
Poly.shared.download(assetWithIdentifier: "10u8FYPC5Br", progressHandler: { (progress) in
}) { (rootFileUrl, resourceFileUrls, error) in
if let rootFileUrl = rootFileUrl {
let node = SCNNode.createNode(withLocalUrl: rootFileUrl)
self._arView?.scene.rootNode.addChildNode(node)
}
}
API也提供私有对象加载功能,但可能需要添加额外的端点。通过 authToken
属性设置了认证支持。
文档
您可以在这里找到文档。文档使用 jazzy 生成的,并托管在 GitHub-Pages。
资源
许可协议
Poly
可在 MIT 许可下获得,更多信息请参阅 LICENSE 文件。