AIXF Media 360 2.0.1 beta

注意：我没有任何苹果产品，所以没有在苹果产品上测试过。这也是它是测试版的部分原因。在灯箱中无法使用。您必须在不使用灯箱的情况下查看它们。

AIXF Media360 让 360°（等角）图像在 XenForo 媒体库中感觉像原生一样。
它检测全景图像，并用一个交互式、可拖动的 360°查看器 （由 Pannellum 提供动力）替换静态照片——直接在标准媒体视图中。

• 即插即用；无需编辑核心文件
• 缩放和全屏控制
• 轻松自动旋转（可选）
• 与普通 JPG 等距圆柱体（2:1 宽高比）兼容，例如 4096×2048 或 8192×4096
• CDN 或本地资源（任选）

---
## 安装

1. 通过管理控制台 → 扩展 → 从存档安装/升级上传发布 ZIP 文件。
2. 安装后，访问媒体库 → 任何等距圆柱全景图（2:1）。
您应该看到拖动查看，以及缩放和全屏控件。

### 使用 CDN（默认）
该插件从公共 CDN 加载 Pannellum。无需额外文件或步骤。

### 使用本地文件（可选）
如果您的 CSP 阻止了 CDN：

- 将本地 Pannellum 文件放置在插件中（如果您使用了“本地”构建，这些文件将被包含）：
在 ACP → 选项 → AIXF Media360（如果您公开了选项），设置 使用 CDN = 关闭。
如果您没有添加 ACP 选项，在挂载中设置 data-cdn="0"（见“如何工作”）。

## 如何使用（简版）

• 在媒体查看页面（public:xfmg_media_view），插件注入了一个小的挂载 div 和一个启动脚本。
• 脚本等待原始<img>，检查其是否为 ~2:1，隐藏它，并使用相同的图片 URL 挂载 Pannellum。
• 您可以通过挂载上的 data-* 标志来控制行为。

示例挂载（已由插件注入；此处仅供参考）：
## 推荐图片尺寸

• 4096×2048 (4K) — 在设备间具有最佳兼容性
• 8192×4096 (8K) — 桌面显示更清晰；文件更大

文件类型：JPG（标准等角圆柱形）。
EXR/HDR 对于此查看器不是必需的（您可以使用色调映射的 JPG）。
---
## 故障排除

我只看到一个静态图像。
很可能是图像的宽高比不是2:1。检查尺寸（例如，4096×2048）。如果您的源文件略偏离2:1，您可以放宽数据比率容忍度（例如，0.08）。

我可以拖动，但没有按钮。
Pannellum 的 CSS 未加载。如果您在 CDN 上，请确保它没有被阻止。对于本地模式，请确认此 URL 在您的浏览器中可以正常工作：
控制台显示 404 错误，表示 init.js 或 pannellum.js 无法加载。

• 使用 &lt;xf:js src="aixf/media360/init.js" /&gt; 是正确的（不要以 js/ 前缀）。
• 如果您自己创建了 ZIP 文件，请确保您的发布版本包含：

CSP 阻止的 CDN。
切换到本地模式（见上方），或为 CDN 域名放宽 CSP。

懒加载警告。
脚本等待实际的<img>加载完成；懒加载是可以的。如果你的主题在较晚的时候交换图像节点，可能会出现短暂的闪烁。

## 路线图（以反馈为导向）

• GPano/XMP EXIF 检测（超过 2:1 比例）
• 移动陀螺仪（默认开启方向）
• “分享此视图”深度链接（URL 中的 yaw/pitch/hfov）
• 热点（标题/链接）
• 可选的 XenAddons 展示支持