安卓集成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字段对应的位置,自然取不到有效值。
可正常获取视频资源的修正方案
- 纠正URI拼接规则
不要手动拼接完整的player.vimeo.com域名路径——VimeoClient初始化时已经内置了正确的API基础域名,请求时直接传入SDK约定的相对路径即可,SDK会自动拼接域名、携带鉴权头完成请求:- 错误写法:
https://player.vimeo.com/videos/123456789/config - 正确基础路径:
/videos/123456789
- 错误写法:
- 显式声明要拉取的字段
Vimeo API做了响应体积优化,默认请求视频详情接口时不会返回体积较大的files视频文件列表,需要在路径后通过fields参数显式声明需要获取的字段;同时要确保你使用的Access Token已经开通了video_files、public(或对应私有视频读取)的权限范围,否则即使请求带了字段声明也无法拿到文件列表。
最终可用的请求URI为:/videos/123456789?fields=uri,name,files - 清理无效冗余代码
你代码中实例化的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
相关产品推荐
相关产品推荐

