Flutter video_player播放ASP.NET Web API流式视频失败求助

API端核心要求排查 #

video_player依赖HTTP范围请求（Range Requests）实现流式播放，你的API必须满足以下条件：

• 支持Range请求头：客户端会发送Range: bytes=start-end请求，API需解析该头，返回对应区间的字节流，而非整个文件。
• 返回正确的响应信息：
  • 状态码必须是206 Partial Content（不能用200）
  • 响应头需包含Content-Range: bytes start-end/total、Accept-Ranges: bytes
  • 正确设置Content-Type（如video/mp4）
• 确保分块传输：ASP.NET Web API返回Stream时通常会自动处理，但需确认未被配置禁用。

API实现修正示例 #

如果你的API未处理Range请求，即使返回Stream也无法被video_player识别，以下是处理范围请求的核心逻辑：

public async Task<IHttpActionResult> GetVideo(string videoId)
{
    var videoPath = GetVideoFilePath(videoId);
    var fileInfo = new FileInfo(videoPath);
    var response = Request.CreateResponse();

    if (Request.Headers.Range != null)
    {
        var range = Request.Headers.Range.Ranges.First();
        var start = range.From ?? 0;
        var end = range.To ?? fileInfo.Length - 1;
        var segmentLength = end - start + 1;

        var stream = new FileStream(videoPath, FileMode.Open, FileAccess.Read, FileShare.Read, 4096, true);
        stream.Seek(start, SeekOrigin.Begin);

        response.StatusCode = HttpStatusCode.PartialContent;
        response.Content = new StreamContent(stream);
        response.Content.Headers.ContentLength = segmentLength;
        response.Content.Headers.ContentRange = new ContentRangeHeaderValue(start, end, fileInfo.Length);
    }
    else
    {
        // 可选：返回完整文件，建议优先强制范围请求
        response.StatusCode = HttpStatusCode.OK;
        response.Content = new StreamContent(new FileStream(videoPath, FileMode.Open, FileAccess.Read, FileShare.Read, 4096, true));
        response.Content.Headers.ContentLength = fileInfo.Length;
    }

    response.Content.Headers.ContentType = new MediaTypeHeaderValue("video/mp4");
    response.Content.Headers.AcceptRanges.Add("bytes");
    return ResponseMessage(response);
}

Flutter端配置与验证 #

• 直接使用networkUrl初始化控制器：video_player会自动处理范围请求，无需手动分块：

final VideoPlayerController controller = VideoPlayerController.networkUrl(
  Uri.parse('https://your-api-domain/api/videos/your-video-id'),
);
await controller.initialize();
controller.play();

• 抓包验证请求：用Charles或Fiddler确认Flutter客户端是否发送Range头，API是否返回206状态码及正确的响应头。
• 检查视频格式：确保视频是video_player支持的格式（如MP4，编码为H.264/AAC），部分特殊编码会导致流式播放失败。

常见问题修复 #

• IIS拦截问题：若API部署在IIS，需在web.config中禁用WebDAV避免拦截范围请求：

<system.webServer>
  <modules runAllManagedModulesForAllRequests="false">
    <remove name="WebDAVModule" />
  </modules>
  <handlers>
    <remove name="WebDAV" />
  </handlers>
</system.webServer>

• 跨域配置：若API与Flutter应用跨域，需在API端配置CORS，允许Range、Content-Range等头的跨域访问。

内容的提问来源于stack exchange，提问作者Nhật Duy Trương