Poly 0.6.0

Poly 0.6.0

patrick piemonte维护。



 
依赖项
Alamofire~> 4.9
PromiseKit~> 6.13
Disk~> 0.6
ObjectMapper~> 4.2
Cache~> 6.0
 

Poly 0.6.0

  • 作者:
  • patrick piemonte

Poly

Poly是一个非官方的Google Poly SDK,用Swift语言编写。

这个库简化了Google Poly的集成,并提供了一些额外的客户端功能。

Build Status Pod Version Swift Version GitHub license

特性
🔍 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 文件。