GJS/GTK4中如何向Video组件传递本地MP4文件？

1. 本地MP4文件存放位置 #

• 开发调试阶段：可放在任意位置，只要应用能通过绝对/相对路径访问到（比如项目根目录下的videos子文件夹）。
• 正式打包发布：
  • 若为应用自带的视频资源，需放在项目data目录下（如data/videos/sample.mp4），打包时通过Meson等工具将文件安装到系统标准路径：${datadir}/${your-app-id}/videos/（例：/usr/share/com.yourdomain.YourApp/videos/）。
  • 若播放用户自定义本地文件，用户可随意存放，但应用需申请对应访问权限（比如Flatpak打包时添加filesystem=home权限）。

2. 文件是否需要注册 #

不需要额外注册，但需注意两点：

• 打包时必须确保自带资源被正确包含到安装包中，比如用Meson的install_data()指令：

  install_data(
    'data/videos/sample.mp4',
    install_dir: join_paths(get_option('datadir'), meson.project_name(), 'videos')
  )
  

• 若播放用户本地文件，应用需具备文件访问权限：Flatpak环境下需在flatpak-manifest.json中添加对应权限，比如访问用户主目录加"filesystem=home"，访问特定路径加"filesystem=/path/to/folder"。

3. 自定义组件中正确传递文件给GtkVideo #

GtkNoMediaFile错误说明GtkVideo未绑定有效媒体文件对象，以下是三种方式的正确实现（结合自定义组件FbrVideoWidget）：

方式1：通过本地路径（new_for_path） #

在组件中封装设置方法并添加错误检查：

import Gtk from 'gi://Gtk?version=4.0';
import Gio from 'gi://Gio';

export class FbrVideoWidget extends Gtk.Box {
  #video;

  constructor() {
    super();
    this.#video = new Gtk.Video();
    this.append(this.#video);

    // 监听媒体错误，排查问题
    this.#video.connect('notify::media-file', () => {
      const mediaFile = this.#video.media_file;
      if (mediaFile) {
        mediaFile.connect('error', (_, error) => {
          console.error('媒体文件错误:', error.message);
        });
      } else {
        console.warn('未绑定有效的媒体文件');
      }
    });
  }

  setVideoPath(path) {
    const file = Gio.File.new_for_path(path);
    if (!file.query_exists(null)) {
      console.error(`文件不存在: ${path}`);
      return;
    }

    try {
      const mediaFile = Gtk.MediaFile.new_for_path(path);
      this.#video.media_file = mediaFile;
    } catch (e) {
      console.error('加载媒体文件失败:', e.message);
    }
  }
}

方式2：通过URI（new_for_uri） #

适用于本地文件（file://开头）或网络地址：

setVideoUri(uri) {
  try {
    const mediaFile = Gtk.MediaFile.new_for_uri(uri);
    this.#video.media_file = mediaFile;
  } catch (e) {
    console.error('加载URI媒体失败:', e.message);
  }
}
// 调用示例：widget.setVideoUri('file:///home/user/Videos/sample.mp4');

方式3：通过应用资源（set_resource） #

适用于打包到应用内的资源，需确保资源路径格式正确：

setVideoResource(resourcePath) {
  // 资源路径格式为 `/com/yourdomain/YourApp/videos/sample.mp4`
  try {
    const mediaFile = Gtk.MediaFile.new_for_resource(resourcePath);
    this.#video.media_file = mediaFile;
  } catch (e) {
    console.error('加载资源媒体失败:', e.message);
  }
}
// 调用示例：widget.setVideoResource('/com/yourdomain/YourApp/videos/sample.mp4');

关键注意点：

• 不要直接调用GtkVideo的静态方法后忽略后续检查，必须确保media_file属性被正确赋值，并通过错误信号排查问题。
• 若播放无反应，需确认GStreamer相关插件已安装（GNOME应用依赖gstreamer1.0-plugins-good等基础插件）。

内容的提问来源于stack exchange，提问作者Kalnode