如何在Autodesk Viewer中展示OSS存储桶内的SVF文件？

问题概述 #

将完整SVF文件包上传至OSS存储桶后，使用Autodesk Viewer的Local环境加载OSS上的0.svf文件时无法正常展示，但替换为官方示例SVF链接可正常加载。

核心原因 #

Viewer加载SVF并非仅读取单个0.svf文件，还需要访问关联的二进制数据文件（.bin）、纹理图片等附属资源。加载失败通常源于以下两点：

• OSS存储桶内的SVF相关文件无公开访问权限，或未生成有效临时访问链接；
• OSS未配置正确的跨域资源共享（CORS）规则，导致Viewer所在域名无法跨域请求资源。

解决步骤 #

1. 确保OSS文件可访问 #

• 将存储桶内所有SVF相关文件（包括0.svf、所有.bin文件、纹理图片等）设置为公开读权限；
• 若需私有存储，生成带有效签名的临时URL，确保签名覆盖所有需要加载的附属文件，且有效期满足需求。

2. 配置OSS跨域规则 #

在OSS控制台配置CORS规则，允许Viewer所在域名发起跨域请求：

• 允许的来源：填写你的HTML页面所在域名（或用*临时测试，生产环境建议指定具体域名）；
• 允许的方法：至少包含GET；
• 允许的请求头：可设置为*，或根据Viewer实际请求头配置；
• 暴露的响应头：按需设置，至少包含Content-Type等基础头。

3. 调整Viewer代码 #

保持env: 'Local'配置不变，document字段直接填写OSS上0.svf的可访问URL（公开URL或带签名的临时URL），确保该URL所在目录下的所有附属文件都能被Viewer通过相对路径访问到。

示例调整后的代码片段：

var options = {
    'env' : 'Local',
    'document': 'https://your-oss-bucket-url/0.svf' // 替换为你的OSS上0.svf的可访问URL
}; 
Autodesk.Viewing.Initializer(options, function() {
    viewer.start(options.document, options);
});

4. 验证调试 #

打开浏览器开发者工具的控制台，查看是否有403（权限错误）或CORS相关错误，根据错误提示进一步调整OSS权限或跨域规则。

内容的提问来源于stack exchange，提问作者小野島昇