AIXF Media 360 2.0.1 Beta

Name: AIXF Media 360
Availability: InStock
Author: axtona

XF 兼容性

2.3.x

摘要: AIXF Media360 — Enhance your XenForo media gallery with 360° panoramic images. Drop-in, no core edits needed; zoom, fullscreen controls, and auto-rotate options included for seamless viewing experience. Supports both CDN and local assets.

注意：我不拥有苹果的产品，因此我没有在任何苹果设备上测试过。这是预览版的原因之一。它不工作在光标模式下。你必须在没有光标模式的情况下查看它们。

# AIXF Media360 — 360°全景图用于XenForo媒体画廊

AIXF Media360使360°（等角投影）图像在XenForo媒体画廊中感觉自然。
它检测到全景图片，并用一个交互式、可拖动的360°查看器（由Pannellum驱动）替换静态照片——直接嵌入标准媒体视图中。

✅ 一键安装；无需核心文件编辑
✅ 放大和全屏控制
✅ 轻柔自动旋转（可选）
✅ 支持普通的JPG等角投影图片，例如4096×2048或8192×4096
✅ CDN或本地资产（你选择）

---
## 安装

1. 通过管理员控制面板 → 扩展程序 → 从档案安装/升级上传发布ZIP包。
2. 安装后，访问媒体画廊 → 任何一张等角投影全景图（2:1比例）的图片。
你应该看到拖动查看、放大和全屏控制。

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

### 使用本地文件（可选）
如果你的内容安全策略阻止了CDN：

- 将本地Pannellum文件放在扩展程序目录中（如果使用了“本地”构建版本，这些文件已包含）：
/js/aixf/media360/pannellum.min.js
/styles/aixf/media360/pannellum.css

- 在ACP → 设置 → AIXF Media360（如果你暴露了一个选项），设置Use CDN = Off。
如果没有添加ACP选项，可以在挂载点中设置data-cdn="0"（见“如何工作”）。

## 如何工作（简版）

在媒体视图页面（公共：xfmg_media_view），插件注入一个小的挂载div和一个启动脚本。
脚本等待原始 <img>，检查它是否大约是2:1比例，隐藏它，并使用相同的图片URL挂载Pannellum。
你可以通过data-*标志控制行为。

HTML：

<div id="aixfPanoMount" class="js-aixf360"
data-enabled="1"
data-cdn="1" <!-- 1 = CDN (default), 0 = local -->
data-fov="75" <!-- initial zoom (HFOV) -->
data-autorotate="1.2" <!-- deg/sec; 0 = off -->
data-fullscreen="1" <!-- show fullscreen button -->
data-ratio-tolerance="0.05" <!-- 2:1 detection tolerance -->
style="width:100%;height:60vh"></div>

推荐的图像尺寸

[]*]4096×2048（4K）最佳兼容性跨设备[]*]8192×4096（8K）— 更 sharp on desktop; 大文件

文件类型：JPEG标准透视圆锥。
EXR/HDR 不需要此视图器，你可以使用去饱和的 JPG 文件。
---只看到静态图片。最有可能的是图片不是~2:1。检查尺寸（例如，4096×2048）。你可以增加data-ratio-tolerance（例如，0.08）如果来源稍微偏离了2:1。我可以拖動，但沒有按鈕。PannellumCSS未加载。如果您在CDN上，请确保它没有被阻止。对于本地模式，请确认此URL可以在浏览器中工作：