mirror of
https://github.com/jellyfin/jellyfin.git
synced 2024-07-09 07:10:34 +02:00
e90fbe90f9
The argument isn't passed to the method but causes the API generator to include an unnecessary parameter. Also fixes some typos in the documentation comments.
681 lines
36 KiB
C#
681 lines
36 KiB
C#
using System;
|
|
using System.Collections.Generic;
|
|
using System.ComponentModel.DataAnnotations;
|
|
using System.Globalization;
|
|
using System.Linq;
|
|
using System.Net.Http;
|
|
using System.Threading;
|
|
using System.Threading.Tasks;
|
|
using Jellyfin.Api.Attributes;
|
|
using Jellyfin.Api.Constants;
|
|
using Jellyfin.Api.Extensions;
|
|
using Jellyfin.Api.Helpers;
|
|
using Jellyfin.Api.ModelBinders;
|
|
using Jellyfin.Api.Models.StreamingDtos;
|
|
using MediaBrowser.Common.Configuration;
|
|
using MediaBrowser.Common.Net;
|
|
using MediaBrowser.Controller.Configuration;
|
|
using MediaBrowser.Controller.Devices;
|
|
using MediaBrowser.Controller.Dlna;
|
|
using MediaBrowser.Controller.Dto;
|
|
using MediaBrowser.Controller.Entities;
|
|
using MediaBrowser.Controller.Library;
|
|
using MediaBrowser.Controller.MediaEncoding;
|
|
using MediaBrowser.Controller.Net;
|
|
using MediaBrowser.Model.Dlna;
|
|
using MediaBrowser.Model.Dto;
|
|
using MediaBrowser.Model.Entities;
|
|
using MediaBrowser.Model.IO;
|
|
using MediaBrowser.Model.MediaInfo;
|
|
using MediaBrowser.Model.Net;
|
|
using MediaBrowser.Model.Querying;
|
|
using Microsoft.AspNetCore.Authorization;
|
|
using Microsoft.AspNetCore.Http;
|
|
using Microsoft.AspNetCore.Mvc;
|
|
using Microsoft.Extensions.Configuration;
|
|
|
|
namespace Jellyfin.Api.Controllers
|
|
{
|
|
/// <summary>
|
|
/// The videos controller.
|
|
/// </summary>
|
|
public class VideosController : BaseJellyfinApiController
|
|
{
|
|
private readonly ILibraryManager _libraryManager;
|
|
private readonly IUserManager _userManager;
|
|
private readonly IDtoService _dtoService;
|
|
private readonly IDlnaManager _dlnaManager;
|
|
private readonly IAuthorizationContext _authContext;
|
|
private readonly IMediaSourceManager _mediaSourceManager;
|
|
private readonly IServerConfigurationManager _serverConfigurationManager;
|
|
private readonly IMediaEncoder _mediaEncoder;
|
|
private readonly IDeviceManager _deviceManager;
|
|
private readonly TranscodingJobHelper _transcodingJobHelper;
|
|
private readonly IHttpClientFactory _httpClientFactory;
|
|
private readonly EncodingHelper _encodingHelper;
|
|
|
|
private readonly TranscodingJobType _transcodingJobType = TranscodingJobType.Progressive;
|
|
|
|
/// <summary>
|
|
/// Initializes a new instance of the <see cref="VideosController"/> class.
|
|
/// </summary>
|
|
/// <param name="libraryManager">Instance of the <see cref="ILibraryManager"/> interface.</param>
|
|
/// <param name="userManager">Instance of the <see cref="IUserManager"/> interface.</param>
|
|
/// <param name="dtoService">Instance of the <see cref="IDtoService"/> interface.</param>
|
|
/// <param name="dlnaManager">Instance of the <see cref="IDlnaManager"/> interface.</param>
|
|
/// <param name="authContext">Instance of the <see cref="IAuthorizationContext"/> interface.</param>
|
|
/// <param name="mediaSourceManager">Instance of the <see cref="IMediaSourceManager"/> interface.</param>
|
|
/// <param name="serverConfigurationManager">Instance of the <see cref="IServerConfigurationManager"/> interface.</param>
|
|
/// <param name="mediaEncoder">Instance of the <see cref="IMediaEncoder"/> interface.</param>
|
|
/// <param name="deviceManager">Instance of the <see cref="IDeviceManager"/> interface.</param>
|
|
/// <param name="transcodingJobHelper">Instance of the <see cref="TranscodingJobHelper"/> class.</param>
|
|
/// <param name="httpClientFactory">Instance of the <see cref="IHttpClientFactory"/> interface.</param>
|
|
/// <param name="encodingHelper">Instance of <see cref="EncodingHelper"/>.</param>
|
|
public VideosController(
|
|
ILibraryManager libraryManager,
|
|
IUserManager userManager,
|
|
IDtoService dtoService,
|
|
IDlnaManager dlnaManager,
|
|
IAuthorizationContext authContext,
|
|
IMediaSourceManager mediaSourceManager,
|
|
IServerConfigurationManager serverConfigurationManager,
|
|
IMediaEncoder mediaEncoder,
|
|
IDeviceManager deviceManager,
|
|
TranscodingJobHelper transcodingJobHelper,
|
|
IHttpClientFactory httpClientFactory,
|
|
EncodingHelper encodingHelper)
|
|
{
|
|
_libraryManager = libraryManager;
|
|
_userManager = userManager;
|
|
_dtoService = dtoService;
|
|
_dlnaManager = dlnaManager;
|
|
_authContext = authContext;
|
|
_mediaSourceManager = mediaSourceManager;
|
|
_serverConfigurationManager = serverConfigurationManager;
|
|
_mediaEncoder = mediaEncoder;
|
|
_deviceManager = deviceManager;
|
|
_transcodingJobHelper = transcodingJobHelper;
|
|
_httpClientFactory = httpClientFactory;
|
|
_encodingHelper = encodingHelper;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Gets additional parts for a video.
|
|
/// </summary>
|
|
/// <param name="itemId">The item id.</param>
|
|
/// <param name="userId">Optional. Filter by user id, and attach user data.</param>
|
|
/// <response code="200">Additional parts returned.</response>
|
|
/// <returns>A <see cref="QueryResult{BaseItemDto}"/> with the parts.</returns>
|
|
[HttpGet("{itemId}/AdditionalParts")]
|
|
[Authorize(Policy = Policies.DefaultAuthorization)]
|
|
[ProducesResponseType(StatusCodes.Status200OK)]
|
|
public ActionResult<QueryResult<BaseItemDto>> GetAdditionalPart([FromRoute, Required] Guid itemId, [FromQuery] Guid? userId)
|
|
{
|
|
var user = userId.HasValue && !userId.Equals(Guid.Empty)
|
|
? _userManager.GetUserById(userId.Value)
|
|
: null;
|
|
|
|
var item = itemId.Equals(Guid.Empty)
|
|
? (!userId.Equals(Guid.Empty)
|
|
? _libraryManager.GetUserRootFolder()
|
|
: _libraryManager.RootFolder)
|
|
: _libraryManager.GetItemById(itemId);
|
|
|
|
var dtoOptions = new DtoOptions();
|
|
dtoOptions = dtoOptions.AddClientFields(Request);
|
|
|
|
BaseItemDto[] items;
|
|
if (item is Video video)
|
|
{
|
|
items = video.GetAdditionalParts()
|
|
.Select(i => _dtoService.GetBaseItemDto(i, dtoOptions, user, video))
|
|
.ToArray();
|
|
}
|
|
else
|
|
{
|
|
items = Array.Empty<BaseItemDto>();
|
|
}
|
|
|
|
var result = new QueryResult<BaseItemDto>
|
|
{
|
|
Items = items,
|
|
TotalRecordCount = items.Length
|
|
};
|
|
|
|
return result;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Removes alternate video sources.
|
|
/// </summary>
|
|
/// <param name="itemId">The item id.</param>
|
|
/// <response code="204">Alternate sources deleted.</response>
|
|
/// <response code="404">Video not found.</response>
|
|
/// <returns>A <see cref="NoContentResult"/> indicating success, or a <see cref="NotFoundResult"/> if the video doesn't exist.</returns>
|
|
[HttpDelete("{itemId}/AlternateSources")]
|
|
[Authorize(Policy = Policies.RequiresElevation)]
|
|
[ProducesResponseType(StatusCodes.Status204NoContent)]
|
|
[ProducesResponseType(StatusCodes.Status404NotFound)]
|
|
public async Task<ActionResult> DeleteAlternateSources([FromRoute, Required] Guid itemId)
|
|
{
|
|
var video = (Video)_libraryManager.GetItemById(itemId);
|
|
|
|
if (video == null)
|
|
{
|
|
return NotFound("The video either does not exist or the id does not belong to a video.");
|
|
}
|
|
|
|
if (video.LinkedAlternateVersions.Length == 0)
|
|
{
|
|
video = (Video)_libraryManager.GetItemById(video.PrimaryVersionId);
|
|
}
|
|
|
|
foreach (var link in video.GetLinkedAlternateVersions())
|
|
{
|
|
link.SetPrimaryVersionId(null);
|
|
link.LinkedAlternateVersions = Array.Empty<LinkedChild>();
|
|
|
|
await link.UpdateToRepositoryAsync(ItemUpdateType.MetadataEdit, CancellationToken.None).ConfigureAwait(false);
|
|
}
|
|
|
|
video.LinkedAlternateVersions = Array.Empty<LinkedChild>();
|
|
video.SetPrimaryVersionId(null);
|
|
await video.UpdateToRepositoryAsync(ItemUpdateType.MetadataEdit, CancellationToken.None).ConfigureAwait(false);
|
|
|
|
return NoContent();
|
|
}
|
|
|
|
/// <summary>
|
|
/// Merges videos into a single record.
|
|
/// </summary>
|
|
/// <param name="ids">Item id list. This allows multiple, comma delimited.</param>
|
|
/// <response code="204">Videos merged.</response>
|
|
/// <response code="400">Supply at least 2 video ids.</response>
|
|
/// <returns>A <see cref="NoContentResult"/> indicating success, or a <see cref="BadRequestResult"/> if less than two ids were supplied.</returns>
|
|
[HttpPost("MergeVersions")]
|
|
[Authorize(Policy = Policies.RequiresElevation)]
|
|
[ProducesResponseType(StatusCodes.Status204NoContent)]
|
|
[ProducesResponseType(StatusCodes.Status400BadRequest)]
|
|
public async Task<ActionResult> MergeVersions([FromQuery, Required, ModelBinder(typeof(CommaDelimitedArrayModelBinder))] Guid[] ids)
|
|
{
|
|
var items = ids
|
|
.Select(i => _libraryManager.GetItemById(i))
|
|
.OfType<Video>()
|
|
.OrderBy(i => i.Id)
|
|
.ToList();
|
|
|
|
if (items.Count < 2)
|
|
{
|
|
return BadRequest("Please supply at least two videos to merge.");
|
|
}
|
|
|
|
var primaryVersion = items.FirstOrDefault(i => i.MediaSourceCount > 1 && string.IsNullOrEmpty(i.PrimaryVersionId));
|
|
if (primaryVersion == null)
|
|
{
|
|
primaryVersion = items
|
|
.OrderBy(i =>
|
|
{
|
|
if (i.Video3DFormat.HasValue || i.VideoType != VideoType.VideoFile)
|
|
{
|
|
return 1;
|
|
}
|
|
|
|
return 0;
|
|
})
|
|
.ThenByDescending(i => i.GetDefaultVideoStream()?.Width ?? 0)
|
|
.First();
|
|
}
|
|
|
|
var alternateVersionsOfPrimary = primaryVersion.LinkedAlternateVersions.ToList();
|
|
|
|
foreach (var item in items.Where(i => i.Id != primaryVersion.Id))
|
|
{
|
|
item.SetPrimaryVersionId(primaryVersion.Id.ToString("N", CultureInfo.InvariantCulture));
|
|
|
|
await item.UpdateToRepositoryAsync(ItemUpdateType.MetadataEdit, CancellationToken.None).ConfigureAwait(false);
|
|
|
|
if (!alternateVersionsOfPrimary.Any(i => string.Equals(i.Path, item.Path, StringComparison.OrdinalIgnoreCase)))
|
|
{
|
|
alternateVersionsOfPrimary.Add(new LinkedChild
|
|
{
|
|
Path = item.Path,
|
|
ItemId = item.Id
|
|
});
|
|
}
|
|
|
|
foreach (var linkedItem in item.LinkedAlternateVersions)
|
|
{
|
|
if (!alternateVersionsOfPrimary.Any(i => string.Equals(i.Path, linkedItem.Path, StringComparison.OrdinalIgnoreCase)))
|
|
{
|
|
alternateVersionsOfPrimary.Add(linkedItem);
|
|
}
|
|
}
|
|
|
|
if (item.LinkedAlternateVersions.Length > 0)
|
|
{
|
|
item.LinkedAlternateVersions = Array.Empty<LinkedChild>();
|
|
await item.UpdateToRepositoryAsync(ItemUpdateType.MetadataEdit, CancellationToken.None).ConfigureAwait(false);
|
|
}
|
|
}
|
|
|
|
primaryVersion.LinkedAlternateVersions = alternateVersionsOfPrimary.ToArray();
|
|
await primaryVersion.UpdateToRepositoryAsync(ItemUpdateType.MetadataEdit, CancellationToken.None).ConfigureAwait(false);
|
|
return NoContent();
|
|
}
|
|
|
|
/// <summary>
|
|
/// Gets a video stream.
|
|
/// </summary>
|
|
/// <param name="itemId">The item id.</param>
|
|
/// <param name="container">The video container. Possible values are: ts, webm, asf, wmv, ogv, mp4, m4v, mkv, mpeg, mpg, avi, 3gp, wmv, wtv, m2ts, mov, iso, flv. </param>
|
|
/// <param name="static">Optional. If true, the original file will be streamed statically without any encoding. Use either no url extension or the original file extension. true/false.</param>
|
|
/// <param name="params">The streaming parameters.</param>
|
|
/// <param name="tag">The tag.</param>
|
|
/// <param name="deviceProfileId">Optional. The dlna device profile id to utilize.</param>
|
|
/// <param name="playSessionId">The play session id.</param>
|
|
/// <param name="segmentContainer">The segment container.</param>
|
|
/// <param name="segmentLength">The segment length.</param>
|
|
/// <param name="minSegments">The minimum number of segments.</param>
|
|
/// <param name="mediaSourceId">The media version id, if playing an alternate version.</param>
|
|
/// <param name="deviceId">The device id of the client requesting. Used to stop encoding processes when needed.</param>
|
|
/// <param name="audioCodec">Optional. Specify a audio codec to encode to, e.g. mp3. If omitted the server will auto-select using the url's extension. Options: aac, mp3, vorbis, wma.</param>
|
|
/// <param name="enableAutoStreamCopy">Whether or not to allow automatic stream copy if requested values match the original source. Defaults to true.</param>
|
|
/// <param name="allowVideoStreamCopy">Whether or not to allow copying of the video stream url.</param>
|
|
/// <param name="allowAudioStreamCopy">Whether or not to allow copying of the audio stream url.</param>
|
|
/// <param name="breakOnNonKeyFrames">Optional. Whether to break on non key frames.</param>
|
|
/// <param name="audioSampleRate">Optional. Specify a specific audio sample rate, e.g. 44100.</param>
|
|
/// <param name="maxAudioBitDepth">Optional. The maximum audio bit depth.</param>
|
|
/// <param name="audioBitRate">Optional. Specify an audio bitrate to encode to, e.g. 128000. If omitted this will be left to encoder defaults.</param>
|
|
/// <param name="audioChannels">Optional. Specify a specific number of audio channels to encode to, e.g. 2.</param>
|
|
/// <param name="maxAudioChannels">Optional. Specify a maximum number of audio channels to encode to, e.g. 2.</param>
|
|
/// <param name="profile">Optional. Specify a specific an encoder profile (varies by encoder), e.g. main, baseline, high.</param>
|
|
/// <param name="level">Optional. Specify a level for the encoder profile (varies by encoder), e.g. 3, 3.1.</param>
|
|
/// <param name="framerate">Optional. A specific video framerate to encode to, e.g. 23.976. Generally this should be omitted unless the device has specific requirements.</param>
|
|
/// <param name="maxFramerate">Optional. A specific maximum video framerate to encode to, e.g. 23.976. Generally this should be omitted unless the device has specific requirements.</param>
|
|
/// <param name="copyTimestamps">Whether or not to copy timestamps when transcoding with an offset. Defaults to false.</param>
|
|
/// <param name="startTimeTicks">Optional. Specify a starting offset, in ticks. 1 tick = 10000 ms.</param>
|
|
/// <param name="width">Optional. The fixed horizontal resolution of the encoded video.</param>
|
|
/// <param name="height">Optional. The fixed vertical resolution of the encoded video.</param>
|
|
/// <param name="videoBitRate">Optional. Specify a video bitrate to encode to, e.g. 500000. If omitted this will be left to encoder defaults.</param>
|
|
/// <param name="subtitleStreamIndex">Optional. The index of the subtitle stream to use. If omitted no subtitles will be used.</param>
|
|
/// <param name="subtitleMethod">Optional. Specify the subtitle delivery method.</param>
|
|
/// <param name="maxRefFrames">Optional.</param>
|
|
/// <param name="maxVideoBitDepth">Optional. The maximum video bit depth.</param>
|
|
/// <param name="requireAvc">Optional. Whether to require avc.</param>
|
|
/// <param name="deInterlace">Optional. Whether to deinterlace the video.</param>
|
|
/// <param name="requireNonAnamorphic">Optional. Whether to require a non anamorphic stream.</param>
|
|
/// <param name="transcodingMaxAudioChannels">Optional. The maximum number of audio channels to transcode.</param>
|
|
/// <param name="cpuCoreLimit">Optional. The limit of how many cpu cores to use.</param>
|
|
/// <param name="liveStreamId">The live stream id.</param>
|
|
/// <param name="enableMpegtsM2TsMode">Optional. Whether to enable the MpegtsM2Ts mode.</param>
|
|
/// <param name="videoCodec">Optional. Specify a video codec to encode to, e.g. h264. If omitted the server will auto-select using the url's extension. Options: h265, h264, mpeg4, theora, vpx, wmv.</param>
|
|
/// <param name="subtitleCodec">Optional. Specify a subtitle codec to encode to.</param>
|
|
/// <param name="transcodeReasons">Optional. The transcoding reason.</param>
|
|
/// <param name="audioStreamIndex">Optional. The index of the audio stream to use. If omitted the first audio stream will be used.</param>
|
|
/// <param name="videoStreamIndex">Optional. The index of the video stream to use. If omitted the first video stream will be used.</param>
|
|
/// <param name="context">Optional. The <see cref="EncodingContext"/>.</param>
|
|
/// <param name="streamOptions">Optional. The streaming options.</param>
|
|
/// <response code="200">Video stream returned.</response>
|
|
/// <returns>A <see cref="FileResult"/> containing the audio file.</returns>
|
|
[HttpGet("{itemId}/stream")]
|
|
[HttpHead("{itemId}/stream", Name = "HeadVideoStream")]
|
|
[ProducesResponseType(StatusCodes.Status200OK)]
|
|
[ProducesVideoFile]
|
|
public async Task<ActionResult> GetVideoStream(
|
|
[FromRoute, Required] Guid itemId,
|
|
[FromQuery] string? container,
|
|
[FromQuery] bool? @static,
|
|
[FromQuery] string? @params,
|
|
[FromQuery] string? tag,
|
|
[FromQuery] string? deviceProfileId,
|
|
[FromQuery] string? playSessionId,
|
|
[FromQuery] string? segmentContainer,
|
|
[FromQuery] int? segmentLength,
|
|
[FromQuery] int? minSegments,
|
|
[FromQuery] string? mediaSourceId,
|
|
[FromQuery] string? deviceId,
|
|
[FromQuery] string? audioCodec,
|
|
[FromQuery] bool? enableAutoStreamCopy,
|
|
[FromQuery] bool? allowVideoStreamCopy,
|
|
[FromQuery] bool? allowAudioStreamCopy,
|
|
[FromQuery] bool? breakOnNonKeyFrames,
|
|
[FromQuery] int? audioSampleRate,
|
|
[FromQuery] int? maxAudioBitDepth,
|
|
[FromQuery] int? audioBitRate,
|
|
[FromQuery] int? audioChannels,
|
|
[FromQuery] int? maxAudioChannels,
|
|
[FromQuery] string? profile,
|
|
[FromQuery] string? level,
|
|
[FromQuery] float? framerate,
|
|
[FromQuery] float? maxFramerate,
|
|
[FromQuery] bool? copyTimestamps,
|
|
[FromQuery] long? startTimeTicks,
|
|
[FromQuery] int? width,
|
|
[FromQuery] int? height,
|
|
[FromQuery] int? videoBitRate,
|
|
[FromQuery] int? subtitleStreamIndex,
|
|
[FromQuery] SubtitleDeliveryMethod? subtitleMethod,
|
|
[FromQuery] int? maxRefFrames,
|
|
[FromQuery] int? maxVideoBitDepth,
|
|
[FromQuery] bool? requireAvc,
|
|
[FromQuery] bool? deInterlace,
|
|
[FromQuery] bool? requireNonAnamorphic,
|
|
[FromQuery] int? transcodingMaxAudioChannels,
|
|
[FromQuery] int? cpuCoreLimit,
|
|
[FromQuery] string? liveStreamId,
|
|
[FromQuery] bool? enableMpegtsM2TsMode,
|
|
[FromQuery] string? videoCodec,
|
|
[FromQuery] string? subtitleCodec,
|
|
[FromQuery] string? transcodeReasons,
|
|
[FromQuery] int? audioStreamIndex,
|
|
[FromQuery] int? videoStreamIndex,
|
|
[FromQuery] EncodingContext? context,
|
|
[FromQuery] Dictionary<string, string> streamOptions)
|
|
{
|
|
var isHeadRequest = Request.Method == System.Net.WebRequestMethods.Http.Head;
|
|
var cancellationTokenSource = new CancellationTokenSource();
|
|
var streamingRequest = new VideoRequestDto
|
|
{
|
|
Id = itemId,
|
|
Container = container,
|
|
Static = @static ?? false,
|
|
Params = @params,
|
|
Tag = tag,
|
|
DeviceProfileId = deviceProfileId,
|
|
PlaySessionId = playSessionId,
|
|
SegmentContainer = segmentContainer,
|
|
SegmentLength = segmentLength,
|
|
MinSegments = minSegments,
|
|
MediaSourceId = mediaSourceId,
|
|
DeviceId = deviceId,
|
|
AudioCodec = audioCodec,
|
|
EnableAutoStreamCopy = enableAutoStreamCopy ?? true,
|
|
AllowAudioStreamCopy = allowAudioStreamCopy ?? true,
|
|
AllowVideoStreamCopy = allowVideoStreamCopy ?? true,
|
|
BreakOnNonKeyFrames = breakOnNonKeyFrames ?? false,
|
|
AudioSampleRate = audioSampleRate,
|
|
MaxAudioChannels = maxAudioChannels,
|
|
AudioBitRate = audioBitRate,
|
|
MaxAudioBitDepth = maxAudioBitDepth,
|
|
AudioChannels = audioChannels,
|
|
Profile = profile,
|
|
Level = level,
|
|
Framerate = framerate,
|
|
MaxFramerate = maxFramerate,
|
|
CopyTimestamps = copyTimestamps ?? false,
|
|
StartTimeTicks = startTimeTicks,
|
|
Width = width,
|
|
Height = height,
|
|
VideoBitRate = videoBitRate,
|
|
SubtitleStreamIndex = subtitleStreamIndex,
|
|
SubtitleMethod = subtitleMethod ?? SubtitleDeliveryMethod.Encode,
|
|
MaxRefFrames = maxRefFrames,
|
|
MaxVideoBitDepth = maxVideoBitDepth,
|
|
RequireAvc = requireAvc ?? false,
|
|
DeInterlace = deInterlace ?? false,
|
|
RequireNonAnamorphic = requireNonAnamorphic ?? false,
|
|
TranscodingMaxAudioChannels = transcodingMaxAudioChannels,
|
|
CpuCoreLimit = cpuCoreLimit,
|
|
LiveStreamId = liveStreamId,
|
|
EnableMpegtsM2TsMode = enableMpegtsM2TsMode ?? false,
|
|
VideoCodec = videoCodec,
|
|
SubtitleCodec = subtitleCodec,
|
|
TranscodeReasons = transcodeReasons,
|
|
AudioStreamIndex = audioStreamIndex,
|
|
VideoStreamIndex = videoStreamIndex,
|
|
Context = context ?? EncodingContext.Streaming,
|
|
StreamOptions = streamOptions
|
|
};
|
|
|
|
using var state = await StreamingHelpers.GetStreamingState(
|
|
streamingRequest,
|
|
Request,
|
|
_authContext,
|
|
_mediaSourceManager,
|
|
_userManager,
|
|
_libraryManager,
|
|
_serverConfigurationManager,
|
|
_mediaEncoder,
|
|
_encodingHelper,
|
|
_dlnaManager,
|
|
_deviceManager,
|
|
_transcodingJobHelper,
|
|
_transcodingJobType,
|
|
cancellationTokenSource.Token)
|
|
.ConfigureAwait(false);
|
|
|
|
if (@static.HasValue && @static.Value && state.DirectStreamProvider != null)
|
|
{
|
|
StreamingHelpers.AddDlnaHeaders(state, Response.Headers, true, startTimeTicks, Request, _dlnaManager);
|
|
|
|
await new ProgressiveFileCopier(state.DirectStreamProvider, null, _transcodingJobHelper, CancellationToken.None)
|
|
{
|
|
AllowEndOfFile = false
|
|
}.WriteToAsync(Response.Body, CancellationToken.None)
|
|
.ConfigureAwait(false);
|
|
|
|
// TODO (moved from MediaBrowser.Api): Don't hardcode contentType
|
|
return File(Response.Body, MimeTypes.GetMimeType("file.ts")!);
|
|
}
|
|
|
|
// Static remote stream
|
|
if (@static.HasValue && @static.Value && state.InputProtocol == MediaProtocol.Http)
|
|
{
|
|
StreamingHelpers.AddDlnaHeaders(state, Response.Headers, true, startTimeTicks, Request, _dlnaManager);
|
|
|
|
var httpClient = _httpClientFactory.CreateClient(NamedClient.Default);
|
|
return await FileStreamResponseHelpers.GetStaticRemoteStreamResult(state, isHeadRequest, httpClient, HttpContext).ConfigureAwait(false);
|
|
}
|
|
|
|
if (@static.HasValue && @static.Value && state.InputProtocol != MediaProtocol.File)
|
|
{
|
|
return BadRequest($"Input protocol {state.InputProtocol} cannot be streamed statically");
|
|
}
|
|
|
|
var outputPath = state.OutputFilePath;
|
|
var outputPathExists = System.IO.File.Exists(outputPath);
|
|
|
|
var transcodingJob = _transcodingJobHelper.GetTranscodingJob(outputPath, TranscodingJobType.Progressive);
|
|
var isTranscodeCached = outputPathExists && transcodingJob != null;
|
|
|
|
StreamingHelpers.AddDlnaHeaders(state, Response.Headers, (@static.HasValue && @static.Value) || isTranscodeCached, startTimeTicks, Request, _dlnaManager);
|
|
|
|
// Static stream
|
|
if (@static.HasValue && @static.Value)
|
|
{
|
|
var contentType = state.GetMimeType("." + state.OutputContainer, false) ?? state.GetMimeType(state.MediaPath);
|
|
|
|
if (state.MediaSource.IsInfiniteStream)
|
|
{
|
|
await new ProgressiveFileCopier(state.MediaPath, null, _transcodingJobHelper, CancellationToken.None)
|
|
{
|
|
AllowEndOfFile = false
|
|
}.WriteToAsync(Response.Body, CancellationToken.None)
|
|
.ConfigureAwait(false);
|
|
|
|
return File(Response.Body, contentType);
|
|
}
|
|
|
|
return FileStreamResponseHelpers.GetStaticFileResult(
|
|
state.MediaPath,
|
|
contentType,
|
|
isHeadRequest,
|
|
HttpContext);
|
|
}
|
|
|
|
// Need to start ffmpeg (because media can't be returned directly)
|
|
var encodingOptions = _serverConfigurationManager.GetEncodingOptions();
|
|
var ffmpegCommandLineArguments = _encodingHelper.GetProgressiveVideoFullCommandLine(state, encodingOptions, outputPath, "superfast");
|
|
return await FileStreamResponseHelpers.GetTranscodedFile(
|
|
state,
|
|
isHeadRequest,
|
|
HttpContext,
|
|
_transcodingJobHelper,
|
|
ffmpegCommandLineArguments,
|
|
_transcodingJobType,
|
|
cancellationTokenSource).ConfigureAwait(false);
|
|
}
|
|
|
|
/// <summary>
|
|
/// Gets a video stream.
|
|
/// </summary>
|
|
/// <param name="itemId">The item id.</param>
|
|
/// <param name="container">The video container. Possible values are: ts, webm, asf, wmv, ogv, mp4, m4v, mkv, mpeg, mpg, avi, 3gp, wmv, wtv, m2ts, mov, iso, flv. </param>
|
|
/// <param name="static">Optional. If true, the original file will be streamed statically without any encoding. Use either no url extension or the original file extension. true/false.</param>
|
|
/// <param name="params">The streaming parameters.</param>
|
|
/// <param name="tag">The tag.</param>
|
|
/// <param name="deviceProfileId">Optional. The dlna device profile id to utilize.</param>
|
|
/// <param name="playSessionId">The play session id.</param>
|
|
/// <param name="segmentContainer">The segment container.</param>
|
|
/// <param name="segmentLength">The segment length.</param>
|
|
/// <param name="minSegments">The minimum number of segments.</param>
|
|
/// <param name="mediaSourceId">The media version id, if playing an alternate version.</param>
|
|
/// <param name="deviceId">The device id of the client requesting. Used to stop encoding processes when needed.</param>
|
|
/// <param name="audioCodec">Optional. Specify a audio codec to encode to, e.g. mp3. If omitted the server will auto-select using the url's extension. Options: aac, mp3, vorbis, wma.</param>
|
|
/// <param name="enableAutoStreamCopy">Whether or not to allow automatic stream copy if requested values match the original source. Defaults to true.</param>
|
|
/// <param name="allowVideoStreamCopy">Whether or not to allow copying of the video stream url.</param>
|
|
/// <param name="allowAudioStreamCopy">Whether or not to allow copying of the audio stream url.</param>
|
|
/// <param name="breakOnNonKeyFrames">Optional. Whether to break on non key frames.</param>
|
|
/// <param name="audioSampleRate">Optional. Specify a specific audio sample rate, e.g. 44100.</param>
|
|
/// <param name="maxAudioBitDepth">Optional. The maximum audio bit depth.</param>
|
|
/// <param name="audioBitRate">Optional. Specify an audio bitrate to encode to, e.g. 128000. If omitted this will be left to encoder defaults.</param>
|
|
/// <param name="audioChannels">Optional. Specify a specific number of audio channels to encode to, e.g. 2.</param>
|
|
/// <param name="maxAudioChannels">Optional. Specify a maximum number of audio channels to encode to, e.g. 2.</param>
|
|
/// <param name="profile">Optional. Specify a specific an encoder profile (varies by encoder), e.g. main, baseline, high.</param>
|
|
/// <param name="level">Optional. Specify a level for the encoder profile (varies by encoder), e.g. 3, 3.1.</param>
|
|
/// <param name="framerate">Optional. A specific video framerate to encode to, e.g. 23.976. Generally this should be omitted unless the device has specific requirements.</param>
|
|
/// <param name="maxFramerate">Optional. A specific maximum video framerate to encode to, e.g. 23.976. Generally this should be omitted unless the device has specific requirements.</param>
|
|
/// <param name="copyTimestamps">Whether or not to copy timestamps when transcoding with an offset. Defaults to false.</param>
|
|
/// <param name="startTimeTicks">Optional. Specify a starting offset, in ticks. 1 tick = 10000 ms.</param>
|
|
/// <param name="width">Optional. The fixed horizontal resolution of the encoded video.</param>
|
|
/// <param name="height">Optional. The fixed vertical resolution of the encoded video.</param>
|
|
/// <param name="videoBitRate">Optional. Specify a video bitrate to encode to, e.g. 500000. If omitted this will be left to encoder defaults.</param>
|
|
/// <param name="subtitleStreamIndex">Optional. The index of the subtitle stream to use. If omitted no subtitles will be used.</param>
|
|
/// <param name="subtitleMethod">Optional. Specify the subtitle delivery method.</param>
|
|
/// <param name="maxRefFrames">Optional.</param>
|
|
/// <param name="maxVideoBitDepth">Optional. The maximum video bit depth.</param>
|
|
/// <param name="requireAvc">Optional. Whether to require avc.</param>
|
|
/// <param name="deInterlace">Optional. Whether to deinterlace the video.</param>
|
|
/// <param name="requireNonAnamorphic">Optional. Whether to require a non anamorphic stream.</param>
|
|
/// <param name="transcodingMaxAudioChannels">Optional. The maximum number of audio channels to transcode.</param>
|
|
/// <param name="cpuCoreLimit">Optional. The limit of how many cpu cores to use.</param>
|
|
/// <param name="liveStreamId">The live stream id.</param>
|
|
/// <param name="enableMpegtsM2TsMode">Optional. Whether to enable the MpegtsM2Ts mode.</param>
|
|
/// <param name="videoCodec">Optional. Specify a video codec to encode to, e.g. h264. If omitted the server will auto-select using the url's extension. Options: h265, h264, mpeg4, theora, vpx, wmv.</param>
|
|
/// <param name="subtitleCodec">Optional. Specify a subtitle codec to encode to.</param>
|
|
/// <param name="transcodeReasons">Optional. The transcoding reason.</param>
|
|
/// <param name="audioStreamIndex">Optional. The index of the audio stream to use. If omitted the first audio stream will be used.</param>
|
|
/// <param name="videoStreamIndex">Optional. The index of the video stream to use. If omitted the first video stream will be used.</param>
|
|
/// <param name="context">Optional. The <see cref="EncodingContext"/>.</param>
|
|
/// <param name="streamOptions">Optional. The streaming options.</param>
|
|
/// <response code="200">Video stream returned.</response>
|
|
/// <returns>A <see cref="FileResult"/> containing the audio file.</returns>
|
|
[HttpGet("{itemId}/stream.{container}")]
|
|
[HttpHead("{itemId}/stream.{container}", Name = "HeadVideoStreamByContainer")]
|
|
[ProducesResponseType(StatusCodes.Status200OK)]
|
|
[ProducesVideoFile]
|
|
public Task<ActionResult> GetVideoStreamByContainer(
|
|
[FromRoute, Required] Guid itemId,
|
|
[FromRoute, Required] string container,
|
|
[FromQuery] bool? @static,
|
|
[FromQuery] string? @params,
|
|
[FromQuery] string? tag,
|
|
[FromQuery] string? deviceProfileId,
|
|
[FromQuery] string? playSessionId,
|
|
[FromQuery] string? segmentContainer,
|
|
[FromQuery] int? segmentLength,
|
|
[FromQuery] int? minSegments,
|
|
[FromQuery] string? mediaSourceId,
|
|
[FromQuery] string? deviceId,
|
|
[FromQuery] string? audioCodec,
|
|
[FromQuery] bool? enableAutoStreamCopy,
|
|
[FromQuery] bool? allowVideoStreamCopy,
|
|
[FromQuery] bool? allowAudioStreamCopy,
|
|
[FromQuery] bool? breakOnNonKeyFrames,
|
|
[FromQuery] int? audioSampleRate,
|
|
[FromQuery] int? maxAudioBitDepth,
|
|
[FromQuery] int? audioBitRate,
|
|
[FromQuery] int? audioChannels,
|
|
[FromQuery] int? maxAudioChannels,
|
|
[FromQuery] string? profile,
|
|
[FromQuery] string? level,
|
|
[FromQuery] float? framerate,
|
|
[FromQuery] float? maxFramerate,
|
|
[FromQuery] bool? copyTimestamps,
|
|
[FromQuery] long? startTimeTicks,
|
|
[FromQuery] int? width,
|
|
[FromQuery] int? height,
|
|
[FromQuery] int? videoBitRate,
|
|
[FromQuery] int? subtitleStreamIndex,
|
|
[FromQuery] SubtitleDeliveryMethod? subtitleMethod,
|
|
[FromQuery] int? maxRefFrames,
|
|
[FromQuery] int? maxVideoBitDepth,
|
|
[FromQuery] bool? requireAvc,
|
|
[FromQuery] bool? deInterlace,
|
|
[FromQuery] bool? requireNonAnamorphic,
|
|
[FromQuery] int? transcodingMaxAudioChannels,
|
|
[FromQuery] int? cpuCoreLimit,
|
|
[FromQuery] string? liveStreamId,
|
|
[FromQuery] bool? enableMpegtsM2TsMode,
|
|
[FromQuery] string? videoCodec,
|
|
[FromQuery] string? subtitleCodec,
|
|
[FromQuery] string? transcodeReasons,
|
|
[FromQuery] int? audioStreamIndex,
|
|
[FromQuery] int? videoStreamIndex,
|
|
[FromQuery] EncodingContext? context,
|
|
[FromQuery] Dictionary<string, string> streamOptions)
|
|
{
|
|
return GetVideoStream(
|
|
itemId,
|
|
container,
|
|
@static,
|
|
@params,
|
|
tag,
|
|
deviceProfileId,
|
|
playSessionId,
|
|
segmentContainer,
|
|
segmentLength,
|
|
minSegments,
|
|
mediaSourceId,
|
|
deviceId,
|
|
audioCodec,
|
|
enableAutoStreamCopy,
|
|
allowVideoStreamCopy,
|
|
allowAudioStreamCopy,
|
|
breakOnNonKeyFrames,
|
|
audioSampleRate,
|
|
maxAudioBitDepth,
|
|
audioBitRate,
|
|
audioChannels,
|
|
maxAudioChannels,
|
|
profile,
|
|
level,
|
|
framerate,
|
|
maxFramerate,
|
|
copyTimestamps,
|
|
startTimeTicks,
|
|
width,
|
|
height,
|
|
videoBitRate,
|
|
subtitleStreamIndex,
|
|
subtitleMethod,
|
|
maxRefFrames,
|
|
maxVideoBitDepth,
|
|
requireAvc,
|
|
deInterlace,
|
|
requireNonAnamorphic,
|
|
transcodingMaxAudioChannels,
|
|
cpuCoreLimit,
|
|
liveStreamId,
|
|
enableMpegtsM2TsMode,
|
|
videoCodec,
|
|
subtitleCodec,
|
|
transcodeReasons,
|
|
audioStreamIndex,
|
|
videoStreamIndex,
|
|
context,
|
|
streamOptions);
|
|
}
|
|
}
|
|
}
|