feat(转换渲染): 完善转换能力与图像渲染

ofdgo_editor_media.go

@@ -0,0 +1,48 @@
+// Copyright 2025-2026 肖其顿 (XIAO QI DUN)
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+package ofdgo
+
+import (
+	"bytes"
+	"crypto/sha256"
+	"fmt"
+	"strings"
+)
+
+// AddMedia 注册音频或视频资源，保持原始编码，资源被动作引用后写入文档
+// 本方法不转码或验证媒体编解码器，播放能力由调用方提供
+// 入参: kind 为Audio或Video, format 媒体格式，可为空, data 完整媒体文件
+// 返回: string 资源标识, error 无效类型或数据
+func (e *Editor) AddMedia(kind, format string, data []byte) (string, error) {
+	if kind != "Audio" && kind != "Video" {
+		return "", fmt.Errorf("media type must be Audio or Video")
+	}
+	if len(data) == 0 {
+		return "", fmt.Errorf("empty media data")
+	}
+	format = strings.ToUpper(strings.TrimSpace(format))
+	key := editorResourceKey{checksum: sha256.Sum256(data), index: -1, kind: kind + "/" + format}
+	if id, ok := e.resourceID[key]; ok {
+		return id, nil
+	}
+	if err := e.prepareSourceIDs(); err != nil {
+		return "", err
+	}
+	id := e.nextID()
+	name := e.packageName("Res/Media/Media_" + id)
+	e.resources = append(e.resources, editorResource{name: name, data: bytes.Clone(data), image: &MultiMedia{ID: id, Type: kind, Format: format, MediaFile: "/" + name}})
+	e.resourceID[key] = id
+	return id, nil
+}