audio-video

用途：在 Decentraland 场景中加入声音与视频。选择判断：本地音频文件用 AudioSource；流媒体（电台、直播音频）用 AudioStream；视频用 VideoPlayer 配合 Material.Texture.Video，需依附于平面或网格。音频文件放 assets/Audio/，支持 .mp3、.ogg、.wav。AudioSource 常用字段有 audioClipUrl、playing、loop、volume、pitch、currentTime、global；默认有空间衰减，global: true 可关闭。重复触发应调用 AudioSource.playSound(entity, clipUrl, resetCursor?)，停止用 stopSound，避免手改 getMutable().playing 被 LWW 去重吞掉。检测自然播放结束应只读 getter 轮询 playing 由 true 变 false 并做边沿检测，或用 audioEventsSystem.registerAudioEventsEntity 回调（PBAudioEvent 含 MediaState 与 timestamp）。二者要求 DCL 2.0 桌面客户端。AudioStream 用于 URL 流，默认非空间。VideoPlayer 需三步：MeshRenderer.setPlane()、添加 VideoPlayer、创建 Material.Texture.Video({ videoPlayerEntity }) 并赋给材质；可用 videoEventsSystem 监听 VS_READY、VS_PLAYING 等状态。限制：浏览器策略要求玩家先点击才能播放音频；VideoPlayer 仅支持 HTTPS，格式为 .mp4(H.264)、.webm、HLS(.m3u8)，避免同时播放多个视频。素材可查 references/audio-catalog.md，下载用 curl -o assets/Audio/<name>.mp3 "<URL>"，下载前应先与用户确认。外部音视频 URL 现无需 ALLOW_MEDIA_HOSTNAMES 权限。