SuperAPI AI 工具集

audio-video

设计与创作

查看项目

更新于 10-16 05:05

技能介绍

用途:在 Decentraland 场景中实现音效、背景音乐、音频流和视频播放。

主要能力:AudioSource 播放本地音频文件,支持空间音频(随距离衰减)与 global 全局播放,可设 volume、pitch、loop;AudioStream 播放外部流媒体 URL(如电台);VideoPlayer 在平面或模型表面播放视频,支持播放、暂停、音量、切换源、播放速率与起始时间,并可绑定到 GLTF 子网格(如电视屏幕)。

使用方式:静态实体(Transform、AudioSource、AudioStream、VideoPlayer、MeshRenderer)在 main-entities.ts 中声明;运行时控制(播放/暂停/音量切换、指针点击触发、视频材质绑定)在 src/index.ts 中通过 getMutable 完成。视频材质需在运行时用 Material.Texture.Video 绑定,因为 Material 需要实体 ID 而非名称。外部媒体 URL 需在 scene.json 中声明 ALLOW_MEDIA_HOSTNAMES 权限及 allowedMediaHostnames。

适用场景:点击音效、背景音乐、电台流、广告牌/屏幕视频、电视或曲面屏视频、多屏共享同一视频源。

限制:AudioSource 仅支持本地文件,不支持外部 URL;视频需 HTTPS;浏览器自动播放策略要求玩家先与场景交互;同时播放视频数量受限(预览 1、Explorer 5、场景最多 10);音频文件应保持较小以缩短加载时间。

分类:设计与创作。