Gets a video stream using HTTP live streaming.

请求参数

Authorization

在 header 添加参数

X-Emby-Token

示例：

X-Emby-Token: ********************

Path 参数

itemId

string <uuid>

必需

The item id.

Query 参数

static

boolean

可选

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.

params

string

可选

The streaming parameters.

tag

string

The tag.

可选

deviceProfileId

string

可选

Optional. The dlna device profile id to utilize.

playSessionId

string

可选

The play session id.

segmentContainer

string

可选

The segment container.

正则匹配:

^[a-zA-Z0-9\-\._,|]{0,40}$

segmentLength

integer <int32>

可选

The segment length.

minSegments

integer <int32>

可选

The minimum number of segments.

mediaSourceId

string

可选

The media version id, if playing an alternate version.

deviceId

string

可选

The device id of the client requesting. Used to stop encoding processes when needed.

audioCodec

string

可选

Optional. Specify an audio codec to encode to, e.g. mp3.

正则匹配:

^[a-zA-Z0-9\-\._,|]{0,40}$

enableAutoStreamCopy

boolean

可选

Whether or not to allow automatic stream copy if requested values match the original source. Defaults to true.

allowVideoStreamCopy

boolean

可选

Whether or not to allow copying of the video stream url.

allowAudioStreamCopy

boolean

可选

Whether or not to allow copying of the audio stream url.

breakOnNonKeyFrames

boolean

可选

Optional. Whether to break on non key frames.

audioSampleRate

integer <int32>

可选

Optional. Specify a specific audio sample rate, e.g. 44100.

maxAudioBitDepth

integer <int32>

可选

Optional. The maximum audio bit depth.

audioBitRate

integer <int32>

可选

Optional. Specify an audio bitrate to encode to, e.g. 128000. If omitted this will be left to encoder defaults.

audioChannels

integer <int32>

可选

Optional. Specify a specific number of audio channels to encode to, e.g. 2.

maxAudioChannels

integer <int32>

可选

Optional. Specify a maximum number of audio channels to encode to, e.g. 2.

profile

string

可选

Optional. Specify a specific an encoder profile (varies by encoder), e.g. main, baseline, high.

level

string

可选

Optional. Specify a level for the encoder profile (varies by encoder), e.g. 3, 3.1.

正则匹配:

-?[0-9]+(?:\.[0-9]+)?

framerate

number <float>

可选

Optional. A specific video framerate to encode to, e.g. 23.976. Generally this should be omitted unless the device has specific requirements.

maxFramerate

number <float>

可选

Optional. A specific maximum video framerate to encode to, e.g. 23.976. Generally this should be omitted unless the device has specific requirements.

copyTimestamps

boolean

可选

Whether or not to copy timestamps when transcoding with an offset. Defaults to false.

startTimeTicks

integer <int64>

可选

Optional. Specify a starting offset, in ticks. 1 tick = 10000 ms.

width

integer <int32>

可选

Optional. The fixed horizontal resolution of the encoded video.

height

integer <int32>

可选

Optional. The fixed vertical resolution of the encoded video.

maxWidth

integer <int32>

可选

Optional. The maximum horizontal resolution of the encoded video.

maxHeight

integer <int32>

可选

Optional. The maximum vertical resolution of the encoded video.

videoBitRate

integer <int32>

可选

Optional. Specify a video bitrate to encode to, e.g. 500000. If omitted this will be left to encoder defaults.

subtitleStreamIndex

integer <int32>

可选

Optional. The index of the subtitle stream to use. If omitted no subtitles will be used.

subtitleMethod

enum<string>

可选

Optional. Specify the subtitle delivery method.

枚举值:

EncodeEmbedExternalHlsDrop

maxRefFrames

integer <int32>

Optional.

可选

maxVideoBitDepth

integer <int32>

可选

Optional. The maximum video bit depth.

requireAvc

boolean

可选

Optional. Whether to require avc.

deInterlace

boolean

可选

Optional. Whether to deinterlace the video.

requireNonAnamorphic

boolean

可选

Optional. Whether to require a non anamorphic stream.

transcodingMaxAudioChannels

integer <int32>

可选

Optional. The maximum number of audio channels to transcode.

cpuCoreLimit

integer <int32>

可选

Optional. The limit of how many cpu cores to use.

liveStreamId

string

可选

The live stream id.

enableMpegtsM2TsMode

boolean

可选

Optional. Whether to enable the MpegtsM2Ts mode.

videoCodec

string

可选

Optional. Specify a video codec to encode to, e.g. h264.

正则匹配:

^[a-zA-Z0-9\-\._,|]{0,40}$

subtitleCodec

string

可选

Optional. Specify a subtitle codec to encode to.

正则匹配:

^[a-zA-Z0-9\-\._,|]{0,40}$

transcodeReasons

string

可选

Optional. The transcoding reason.

audioStreamIndex

integer <int32>

可选

Optional. The index of the audio stream to use. If omitted the first audio stream will be used.

videoStreamIndex

integer <int32>

可选

Optional. The index of the video stream to use. If omitted the first video stream will be used.

context

enum<string>

可选

Optional. The MediaBrowser.Model.Dlna.EncodingContext.

枚举值:

StreamingStatic

enableAudioVbrEncoding

boolean

可选

Optional. Whether to enable Audio Encoding.

默认值:

true

alwaysBurnInSubtitleWhenTranscoding

boolean

可选

Whether to always burn in subtitles when transcoding.

默认值:

false

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request GET '/Videos//main.m3u8?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&maxWidth&maxHeight&videoBitRate&subtitleStreamIndex&subtitleMethod&maxRefFrames&maxVideoBitDepth&requireAvc&deInterlace&requireNonAnamorphic&transcodingMaxAudioChannels&cpuCoreLimit&liveStreamId&enableMpegtsM2TsMode&videoCodec&subtitleCodec&transcodeReasons&audioStreamIndex&videoStreamIndex&context&enableAudioVbrEncoding&alwaysBurnInSubtitleWhenTranscoding' \
--header 'X-Emby-Token;'

返回响应

🟢200成功

application/x-mpegURL

Video stream returned.

Body

object {0}

示例

{}

🟠401没有权限

🟠403禁止访问