You need to enable JavaScript to run this app. 安卓集成Vimeo Networking Java库播放视频时videoFiles为null问题
优惠活动
大模型
产品
解决方案
定价
更多

安卓集成Vimeo Networking Java库播放视频时videoFiles为null问题

问题根因拆解

两类异常的触发逻辑

  • 传入https://player.vimeo.com/videos/123456789抛出malformed JSON错误的核心原因:player.vimeo.com是Vimeo的网页播放器专用域名,该路径返回的是HTML格式的播放器页面源码,并非API约定的JSON结构化响应,JSON解析器拿到HTML内容时自然会触发格式校验错误。
  • 传入带/config后缀的同域名地址后video.files返回null的核心原因:该config接口是专为网页播放器拉取播放配置设计的,返回的JSON数据结构和官方Android SDK定义的Video模型字段映射规则完全不匹配,反序列化流程找不到files字段对应的位置,自然取不到有效值。

可正常获取视频资源的修正方案

  1. 纠正URI拼接规则
    不要手动拼接完整的player.vimeo.com域名路径——VimeoClient初始化时已经内置了正确的API基础域名,请求时直接传入SDK约定的相对路径即可,SDK会自动拼接域名、携带鉴权头完成请求:
    • 错误写法:https://player.vimeo.com/videos/123456789/config
    • 正确基础路径:/videos/123456789
  2. 显式声明要拉取的字段
    Vimeo API做了响应体积优化,默认请求视频详情接口时不会返回体积较大的files视频文件列表,需要在路径后通过fields参数显式声明需要获取的字段;同时要确保你使用的Access Token已经开通了video_files、public(或对应私有视频读取)的权限范围,否则即使请求带了字段声明也无法拿到文件列表。
    最终可用的请求URI为:/videos/123456789?fields=uri,name,files
  3. 清理无效冗余代码
    你代码中实例化的GsonDeserializer gsonDeserializer = new GsonDeserializer();没有传入任何请求链路,属于完全没有生效的冗余代码,可以直接删除。

修正后的核心播放逻辑代码示例

// 使用符合SDK规则的URI,显式指定需要返回files字段
final String uri = "/videos/123456789?fields=uri,name,files";
VimeoClient.getInstance().fetchNetworkContent(uri, new ModelCallback<Video>(Video.class) {
    @Override
    public void success(Video video) {
        ArrayList<VideoFile> videoFiles = video.files;
        Log.i("TAG2", "VideoFiles " + videoFiles);
        if (videoFiles != null && !videoFiles.isEmpty()) {
            // 可根据分辨率、码率、帧率对文件列表排序后选择目标清晰度
            VideoFile videoFile = videoFiles.get(0);
            String playLink = videoFile.getLink();
            Log.i("TAG4", "link " + playLink);
            
            videoView.setVisibility(View.VISIBLE);
            videoView.setVideoURI(Uri.parse(playLink));
            MediaController mediaController = new MediaController(PlayActivity.this);
            mediaController.setAnchorView(videoView);
            videoView.setMediaController(mediaController);
            videoView.requestFocus();
            videoView.start();
        }
    }

    @Override
    public void failure(VimeoError error) {
        Log.i("TAG5", "Vimeo error  : " + error.getErrorMessage());
        Toast.makeText(PlayActivity.this, "failure due to " + error.getErrorMessage(), Toast.LENGTH_SHORT).show();
    }
});

内容的提问来源于stack exchange,提问作者Aditya Anand

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.15 23:06:07