ffmpeg-protocols - Trực tuyến trên Đám mây

CHƯƠNG TRÌNH:

TÊN

giao thức ffmpeg - giao thức FFmpeg

MÔ TẢ

Tài liệu này mô tả các giao thức đầu vào và đầu ra được cung cấp bởi libavformat
thư viện.

BẢO VỆ

Giao thức là các phần tử được định cấu hình trong FFmpeg cho phép truy cập vào các tài nguyên yêu cầu
các giao thức cụ thể.

Khi bạn định cấu hình bản dựng FFmpeg của mình, tất cả các giao thức được hỗ trợ đều được bật theo mặc định.
Bạn có thể liệt kê tất cả những cái có sẵn bằng cách sử dụng tùy chọn cấu hình "--list-protocols".

Bạn có thể tắt tất cả các giao thức bằng cách sử dụng tùy chọn cấu hình "--disable-protocols" và
bật một cách chọn lọc một giao thức bằng cách sử dụng tùy chọn "--enable-protocol =BẢO VỆ", hoặc bạn có thể
vô hiệu hóa một giao thức cụ thể bằng cách sử dụng tùy chọn "--disable-protocol =BẢO VỆ".

Tùy chọn "-protocols" của các công cụ ff * sẽ hiển thị danh sách các giao thức được hỗ trợ.

Sau đây là mô tả về các giao thức hiện có sẵn.

không đồng bộ
Trình bao bọc lấp đầy dữ liệu không đồng bộ cho luồng đầu vào.

Điền dữ liệu vào một luồng nền, để tách hoạt động I / O khỏi luồng demux.

không đồng bộ:
không đồng bộ:http://host/resource
async: cache:http://host/resource

làm mờ
Đọc danh sách phát BluRay.

Các tùy chọn được chấp nhận là:

góc
Góc BluRay

chương
Bắt đầu chương (1 ... N)

danh sách
Danh sách phát để đọc (BDMV / PLAYLIST / ?????. Mpls)

Ví dụ:

Đọc danh sách phát dài nhất từ ​​BluRay được gắn vào / mnt / bluray:

bluray: / mnt / bluray

Đọc góc 2 của danh sách phát 4 từ BluRay được gắn vào / mnt / bluray, bắt đầu từ chương 2:

-playlist 4 -angle 2 -chapter 2 bluray: / mnt / bluray

bộ nhớ cache
Trình bao bọc bộ nhớ đệm cho luồng đầu vào.

Lưu trữ luồng đầu vào vào tệp tạm thời. Nó mang lại khả năng tìm kiếm cho các luồng trực tiếp.

bộ nhớ đệm:

concat
Giao thức nối vật lý.

Đọc và tìm kiếm từ nhiều tài nguyên theo trình tự như thể chúng là một tài nguyên duy nhất.

URL được giao thức này chấp nhận có cú pháp:

kết hợp: | | ... |

Ở đâu URL1, URL2, ..., URLN là các url của tài nguyên sẽ được nối với nhau, mỗi url
có thể chỉ định một giao thức riêng biệt.

Ví dụ để đọc một chuỗi các tệp chia1.mpeg, chia2.mpeg, chia3.mpeg với ffplay
sử dụng lệnh:

ffplay concat: split1.mpeg \ | split2.mpeg \ | split3.mpeg

Lưu ý rằng bạn có thể cần phải thoát khỏi ký tự "|" mà là đặc biệt cho nhiều vỏ.

Crypto
Giao thức đọc luồng được mã hóa AES.

Các tùy chọn được chấp nhận là:

chính Đặt khối nhị phân khóa giải mã AES từ biểu diễn thập lục phân đã cho.

iv Đặt khối nhị phân vectơ khởi tạo giải mã AES từ hệ thập lục phân đã cho
sự đại diện.

Các định dạng URL được chấp nhận:

tiền điện tử:
tiền điện tử +

dữ liệu
Dữ liệu nội dòng trong URI. Nhìn thấyhttp://en.wikipedia.org/wiki/Data_URI_scheme>.

Ví dụ: để chuyển đổi một tệp GIF được cung cấp nội dòng với ffmpeg:

ffmpeg -i "data:image/gif;base64,R0lGODdhCAAIAMIEAAAAAAAA//8AAP//AP///////////////ywAAAAACAAIAAADF0gEDLojDgdGiJdJqUX02iB4E8Q9jUMkADs=" smiley.png

hồ sơ
Giao thức truy cập tệp.

Đọc từ hoặc ghi vào một tệp.

URL tệp có thể có dạng:

tập tin:

Ở đâu tên tập tin là đường dẫn của tệp để đọc.

URL không có tiền tố giao thức sẽ được coi là URL tệp. Phụ thuộc vào
bản dựng, một URL trông giống như một đường dẫn Windows với ký tự ổ đĩa ở đầu
cũng sẽ được giả định là một URL tệp (thường không phải như vậy trong các bản dựng dành cho unix-like
hệ thống).

Ví dụ để đọc từ một tệp đầu vào.mpeg với ffmpeg sử dụng lệnh:

tệp ffmpeg -i: input.mpeg output.mpeg

Giao thức này chấp nhận các tùy chọn sau:

cắt bớt
Cắt bớt các tệp hiện có khi ghi, nếu được đặt thành 1. Giá trị 0 ngăn việc cắt ngắn.
Giá trị mặc định là 1.

kích thước khối
Đặt kích thước khối tối đa của hoạt động I / O, tính bằng byte. Giá trị mặc định là "INT_MAX",
dẫn đến không giới hạn kích thước khối được yêu cầu. Đặt giá trị này thấp hợp lý
cải thiện thời gian phản hồi yêu cầu chấm dứt của người dùng, điều này có giá trị đối với các tệp chậm
Trung bình.

ftp
FTP (Giao thức truyền tệp).

Đọc từ hoặc ghi vào tài nguyên từ xa bằng giao thức FTP.

Cú pháp sau là bắt buộc.

ftp: // [user [: password] @] server [: port] /path/to/remote/resource.mpeg

Giao thức này chấp nhận các tùy chọn sau.

thời gian chờ
Đặt thời gian chờ tính bằng micro giây của các hoạt động I / O socket được sử dụng bởi mức thấp bên dưới
hoạt động. Theo mặc định, nó được đặt thành -1, có nghĩa là thời gian chờ không được chỉ định.

ftp-nặc danh-mật khẩu
Mật khẩu được sử dụng khi đăng nhập với tư cách người dùng ẩn danh. Thông thường, một địa chỉ e-mail phải là
đã sử dụng.

ftp-ghi-có thể tìm kiếm
Kiểm soát khả năng tìm kiếm của kết nối trong quá trình mã hóa. Nếu được đặt thành 1, tài nguyên là
được cho là có thể tìm kiếm được, nếu được đặt thành 0 thì nó được cho là không thể tìm kiếm được. Giá trị mặc định
là 0.

LƯU Ý: Giao thức có thể được sử dụng làm đầu ra, nhưng không nên làm điều đó, trừ khi đặc biệt
cẩn thận (kiểm tra, cấu hình máy chủ tùy chỉnh, v.v.). Các máy chủ FTP khác nhau hoạt động
theo cách khác nhau trong quá trình hoạt động tìm kiếm. công cụ ff * có thể tạo ra nội dung không đầy đủ do
hạn chế của máy chủ.

chuột túi má
Giao thức Gopher.

hls
Đọc luồng được phân đoạn tuân thủ Apple HTTP Live Streaming như một luồng thống nhất. M3U8
danh sách phát mô tả các phân đoạn có thể là tài nguyên HTTP từ xa hoặc tệp cục bộ, được truy cập
sử dụng giao thức tệp tiêu chuẩn. Giao thức lồng nhau được khai báo bằng cách chỉ định "+do đó"
sau tên lược đồ URI hls, trong đó do đó là "tệp" hoặc "http".

hls +http://host/path/to/remote/resource.m3u8
hls + tệp: //path/to/local/resource.m3u8

Việc sử dụng giao thức này không được khuyến khích - trình demuxer hls cũng nên hoạt động (nếu không,
vui lòng báo cáo các vấn đề) và hoàn thiện hơn. Để sử dụng demuxer hls thay thế, chỉ cần
sử dụng các URL trực tiếp đến các tệp m3u8.

http
HTTP (Giao thức truyền siêu văn bản).

Giao thức này chấp nhận các tùy chọn sau:

có thể tìm kiếm
Kiểm soát khả năng tìm kiếm của kết nối. Nếu được đặt thành 1, tài nguyên được cho là
có thể tìm kiếm được, nếu được đặt thành 0, nó được cho là không thể tìm kiếm được, nếu được đặt thành -1, nó sẽ cố gắng
tự động phát hiện nếu nó có thể tìm kiếm được. Giá trị mặc định là -1.

chunked_post
Nếu được đặt thành 1, hãy sử dụng Mã hóa chuyển theo khối cho các bài đăng, mặc định là 1.

nội dung_type
Đặt một loại nội dung cụ thể cho các tin nhắn ĐĂNG.

tiêu đề
Đặt tiêu đề HTTP tùy chỉnh, có thể ghi đè tiêu đề mặc định được tích hợp sẵn. Giá trị phải là
mã hóa chuỗi tiêu đề.

nhiều_request
Sử dụng kết nối liên tục nếu được đặt thành 1, mặc định là 0.

dữ liệu bài đăng
Đặt dữ liệu bài đăng HTTP tùy chỉnh.

user-agent
đại lý người dùng
Ghi đè tiêu đề Tác nhân người dùng. Nếu không được chỉ định, giao thức sẽ sử dụng một chuỗi
mô tả bản dựng libavformat. ("Lavf / ")

thời gian chờ
Đặt thời gian chờ tính bằng micro giây của các hoạt động I / O socket được sử dụng bởi mức thấp bên dưới
hoạt động. Theo mặc định, nó được đặt thành -1, có nghĩa là thời gian chờ không được chỉ định.

mime_type
Xuất loại MIME.

băng giá Nếu được đặt thành 1 yêu cầu siêu dữ liệu ICY (SHOUTcast) từ máy chủ. Nếu máy chủ hỗ trợ
điều này, siêu dữ liệu phải được ứng dụng truy xuất bằng cách đọc
icy_metadata_headers và icy_metadata_packet tùy chọn. Giá trị mặc định là 1.

icy_metadata_headers
Nếu máy chủ hỗ trợ siêu dữ liệu ICY, siêu dữ liệu này chứa phản hồi HTTP dành riêng cho ICY
tiêu đề, được phân tách bằng ký tự dòng mới.

icy_metadata_packet
Nếu máy chủ hỗ trợ siêu dữ liệu ICY và băng giá đã được đặt thành 1, điều này chứa cuối cùng không phải
gói siêu dữ liệu trống do máy chủ gửi. Nó nên được thăm dò định kỳ bởi
các ứng dụng quan tâm đến cập nhật siêu dữ liệu giữa luồng.

bánh quy
Đặt cookie sẽ được gửi trong các yêu cầu trong tương lai. Định dạng của mỗi cookie đều giống nhau
dưới dạng giá trị của trường phản hồi HTTP Set-Cookie. Nhiều cookie có thể được phân định bằng
một ký tự dòng mới.

bù đắp
Đặt độ lệch byte ban đầu.

end_offset
Cố gắng giới hạn yêu cầu ở các byte trước phần bù này.

phương pháp
Khi được sử dụng như một tùy chọn máy khách, nó sẽ đặt phương thức HTTP cho yêu cầu.

Khi được sử dụng như một tùy chọn máy chủ, nó đặt phương thức HTTP sẽ được mong đợi từ
(các) khách hàng. Nếu phương thức HTTP mong đợi và đã nhận không khớp với máy khách
sẽ nhận được phản hồi Yêu cầu Không hợp lệ. Khi bỏ đặt, phương thức HTTP không được kiểm tra
hiện nay. Điều này sẽ được thay thế bằng tính năng tự động phát hiện trong tương lai.

nghe
Nếu được đặt thành 1 sẽ bật máy chủ HTTP thử nghiệm. Điều này có thể được sử dụng để gửi dữ liệu khi được sử dụng
như một tùy chọn đầu ra hoặc đọc dữ liệu từ một ứng dụng khách với HTTP POST khi được sử dụng làm đầu vào
Lựa chọn. Nếu được đặt thành 2, sẽ bật máy chủ HTTP mutli-client thử nghiệm. Điều này vẫn chưa
được triển khai trong ffmpeg.c hoặc ffserver.c và do đó không được sử dụng như một dòng lệnh
tùy chọn.

# Phía máy chủ (đang gửi):
ffmpeg -i somefile.ogg -c copy -listen 1 -f ogg http: // :

# Phía khách hàng (nhận):
ffmpeg -i http: // : -c sao chép somefile.ogg

# Ứng dụng khách cũng có thể được thực hiện với wget:
truy cập http: // : -O somefile.ogg

# Phía máy chủ (nhận):
ffmpeg -listen 1 -i http: // : -c sao chép somefile.ogg

# Phía khách hàng (đang gửi):
ffmpeg -i somefile.ogg -chunked_post 0 -c copy -f ogg http: // :

# Ứng dụng khách cũng có thể được thực hiện với wget:
wget --post-file = somefile.ogg http: // :

HTTP Cookies

Một số yêu cầu HTTP sẽ bị từ chối trừ khi các giá trị cookie được chuyển cùng với yêu cầu. Các
bánh quy tùy chọn cho phép các cookie này được chỉ định. Ít nhất, mỗi cookie phải
chỉ định một giá trị cùng với một đường dẫn và miền. Yêu cầu HTTP phù hợp với cả miền
và đường dẫn sẽ tự động bao gồm giá trị cookie trong trường tiêu đề Cookie HTTP.
Nhiều cookie có thể được phân tách bằng một dòng mới.

Cú pháp bắt buộc để phát luồng chỉ định cookie là:

ffplay -cookies "nlqptid = nltid = tsn; path = /; domain = somedomain.com;" http://somedomain.com/somestream.m3u8

Icecast
Giao thức Icecast (truyền trực tuyến đến máy chủ Icecast)

Giao thức này chấp nhận các tùy chọn sau:

thể loại băng
Đặt thể loại luồng.

tên băng
Đặt tên luồng.

băng_description
Đặt mô tả luồng.

Ice_url
Đặt URL trang web luồng.

băng_công khai
Đặt xem luồng có nên công khai hay không. Giá trị mặc định là 0 (không công khai).

đại lý người dùng
Ghi đè tiêu đề Tác nhân người dùng. Nếu không được chỉ định một chuỗi có dạng "Lavf / "
sẽ được sử dụng.

mật khẩu
Đặt mật khẩu điểm gắn kết Icecast.

nội dung_type
Đặt loại nội dung luồng. Điều này phải được đặt nếu nó khác với audio / mpeg.

inherit_icecast
Điều này cho phép hỗ trợ các phiên bản Icecast <2.4.0, không hỗ trợ HTTP PUT
phương pháp nhưng là phương pháp NGUỒN.

icecast: // [ [: ] @] : /

mmt
Giao thức MMS (Microsoft Media Server) qua TCP.

ừm
Giao thức MMS (Microsoft Media Server) qua HTTP.

Cú pháp bắt buộc là:

mmsh: // [: ] [/ ] [/ ]

md5
Giao thức đầu ra MD5.

Tính toán băm MD5 của dữ liệu sẽ được ghi và khi đóng thì ghi dữ liệu này vào
đầu ra được chỉ định hoặc stdout nếu không có sản phẩm nào được chỉ định. Nó có thể được sử dụng để kiểm tra muxers mà không cần
viết một tập tin thực tế.

Một số ví dụ sau đây.

# Ghi băm MD5 của tệp AVI được mã hóa vào tệp output.avi.md5.
ffmpeg -i input.flv -f avi -y md5: output.avi.md5

# Ghi băm MD5 của tệp AVI được mã hóa vào stdout.
ffmpeg -i input.flv -f avi -y md5:

Lưu ý rằng một số định dạng (thường là MOV) yêu cầu giao thức đầu ra có thể tìm kiếm được, vì vậy chúng
sẽ không thành công với giao thức đầu ra MD5.

đường ống
Giao thức truy cập đường ống UNIX.

Đọc và ghi từ các đường ống UNIX.

Cú pháp được chấp nhận là:

đường ống:[ ]

con số là số tương ứng với bộ mô tả tệp của đường ống (ví dụ: 0 cho stdin, 1
cho stdout, 2 cho stderr). Nếu như con số không được chỉ định, theo mặc định là tệp stdout
bộ mô tả sẽ được sử dụng để viết, stdin để đọc.

Ví dụ để đọc từ stdin với ffmpeg:

cat test.wav | ống ffmpeg -i: 0
# ... điều này giống với ...
cat test.wav | ống ffmpeg -i:

Để viết lách với ffmpeg:

ffmpeg -i test.wav -f avi pipe: 1 | cat> test.avi
# ... điều này giống với ...
ffmpeg -i test.wav -f avi pipe: | cat> test.avi

Giao thức này chấp nhận các tùy chọn sau:

kích thước khối
Đặt kích thước khối tối đa của hoạt động I / O, tính bằng byte. Giá trị mặc định là "INT_MAX",
dẫn đến không giới hạn kích thước khối được yêu cầu. Đặt giá trị này thấp hợp lý
cải thiện thời gian phản hồi yêu cầu chấm dứt của người dùng, điều này có giá trị nếu dữ liệu
đường truyền chậm.

Lưu ý rằng một số định dạng (thường là MOV), yêu cầu giao thức đầu ra có thể tìm kiếm được, vì vậy
chúng sẽ không thành công với giao thức đầu ra đường ống.

rtmp
Giao thức nhắn tin thời gian thực.

Giao thức Nhắn tin Thời gian Thực (RTMP) được sử dụng để truyền trực tuyến nội dung đa phương tiện qua một
Mạng TCP / IP.

Cú pháp bắt buộc là:

rtmp: // [ : @] [: ] [/ ] [/ ] [/ ]

Các thông số được chấp nhận là:

tên truy nhập
Tên người dùng tùy chọn (chủ yếu để xuất bản).

mật khẩu
Mật khẩu tùy chọn (chủ yếu để xuất bản).

máy chủ
Địa chỉ của máy chủ RTMP.

cổng
Số cổng TCP sẽ sử dụng (theo mặc định là 1935).

ứng dụng Nó là tên của ứng dụng để truy cập. Nó thường tương ứng với đường dẫn mà
ứng dụng được cài đặt trên máy chủ RTMP (ví dụ: / ondemand /, / flash / live /, Vv).
Bạn cũng có thể ghi đè giá trị được phân tích cú pháp từ URI thông qua tùy chọn "rtmp_app".

đường chơi
Đây là đường dẫn hoặc tên của tài nguyên để phát tham chiếu đến ứng dụng
quy định tại ứng dụng, có thể có tiền tố là "mp4:". Bạn có thể ghi đè giá trị được phân tích cú pháp từ
cả URI thông qua tùy chọn "rtmp_playpath".

nghe
Hoạt động như một máy chủ, lắng nghe kết nối đến.

thời gian chờ
Thời gian tối đa để chờ kết nối đến. Ngụ ý lắng nghe.

Ngoài ra, các tham số sau có thể được đặt thông qua các tùy chọn dòng lệnh (hoặc trong mã qua
"AVOption" s):

rtmp_app
Tên ứng dụng để kết nối trên máy chủ RTMP. Tùy chọn này ghi đè tham số
được chỉ định trong URI.

rtmp_buffer
Đặt thời gian đệm của máy khách tính bằng mili giây. Giá trị mặc định là 3000.

rtmp_conn
Các tham số kết nối AMF tùy ý bổ sung, được phân tích cú pháp từ một chuỗi, ví dụ như "B: 1
S: authMe O: 1 NN: mã: 1.23 NS: flag: ok O: 0 ". Mỗi giá trị được bắt đầu bởi một giá trị duy nhất
ký tự biểu thị kiểu, B cho Boolean, N cho số, S cho chuỗi, O cho đối tượng,
hoặc Z cho null, theo sau là dấu hai chấm. Đối với Booleans, dữ liệu phải là 0 hoặc 1 cho
FALSE hoặc TRUE, tương ứng. Tương tự như vậy đối với Đối tượng, dữ liệu phải là 0 hoặc 1 để kết thúc hoặc
bắt đầu một đối tượng, tương ứng. Các mục dữ liệu trong subobjects có thể được đặt tên, bằng cách thêm tiền tố
nhập với 'N' và chỉ định tên trước giá trị (tức là "NB: myFlag: 1"). Cái này
tùy chọn có thể được sử dụng nhiều lần để tạo chuỗi AMF tùy ý.

rtmp_flashver
Phiên bản của plugin Flash được sử dụng để chạy trình phát SWF. Mặc định là LNX 9,0,124,2.
(Khi xuất bản, mặc định là FMLE / 3.0 (tương thích; ).)

rtmp_flush_interval
Số lượng gói được gửi trong cùng một yêu cầu (chỉ RTMPT). Giá trị mặc định là 10.

rtmp_live
Chỉ định rằng phương tiện là một luồng trực tiếp. Không tiếp tục hoặc tìm kiếm trong luồng trực tiếp là
khả thi. Giá trị mặc định là "bất kỳ", có nghĩa là người đăng ký lần đầu tiên thử chơi
luồng trực tiếp được chỉ định trong playpath. Nếu không tìm thấy luồng trực tiếp có tên đó,
nó phát luồng đã ghi. Các giá trị có thể có khác là "trực tiếp" và "được ghi lại".

rtmp_pageurl
URL của trang web mà phương tiện được nhúng. Theo mặc định, không có giá trị nào được gửi.

rtmp_playpath
Dòng nhận dạng để phát hoặc để xuất bản. Tùy chọn này ghi đè thông số được chỉ định
trong URI.

rtmp_subscribe
Tên của luồng trực tiếp để đăng ký. Theo mặc định, không có giá trị nào được gửi. Nó chỉ là
được gửi nếu tùy chọn được chỉ định hoặc nếu rtmp_live được đặt thành hoạt động.

rtmp_swfhash
Hàm băm SHA256 của tệp SWF được giải nén (32 byte).

rtmp_swfsize
Kích thước của tệp SWF được giải nén, cần thiết cho SWFVerification.

rtmp_swfurl
URL của trình phát SWF cho phương tiện. Theo mặc định, không có giá trị nào được gửi.

rtmp_swfxác minh
URL tới tệp swf của trình phát, tự động tính toán băm / kích thước.

rtmp_tcurl
URL của luồng mục tiêu. Mặc định là proto: // host [: port] / app.

Ví dụ để đọc với ffplay tài nguyên đa phương tiện có tên "mẫu" từ ứng dụng
"vod" từ máy chủ RTMP "myserver":

ffplay rtmp: // myserver / vod / sample

Để xuất bản lên máy chủ được bảo vệ bằng mật khẩu, hãy chuyển playpath và tên ứng dụng riêng biệt:

ffmpeg -re -i -f flv -rtmp_playpath some / long / path -rtmp_app long / app / name rtmp: // username: password @ myserver /

rtmpe
Giao thức nhắn tin thời gian thực được mã hóa.

Giao thức nhắn tin thời gian thực được mã hóa (RTMPE) được sử dụng để phát trực tuyến đa phương tiện
nội dung trong các nguyên thủy mật mã tiêu chuẩn, bao gồm khóa Diffie-Hellman
trao đổi và HMACSHA256, tạo ra một cặp khóa RC4.

rtmp
Giao thức nhắn tin thời gian thực qua kết nối SSL an toàn.

Giao thức nhắn tin thời gian thực (RTMPS) được sử dụng để truyền trực tuyến nội dung đa phương tiện qua
một kết nối được mã hóa.

rtmpt
Giao thức nhắn tin thời gian thực thông qua HTTP.

Giao thức nhắn tin thời gian thực được truyền qua HTTP (RTMPT) được sử dụng để phát trực tuyến
nội dung đa phương tiện trong các yêu cầu HTTP để vượt qua tường lửa.

rtmpte
Giao thức nhắn tin thời gian thực được mã hóa thông qua HTTP.

Giao thức nhắn tin thời gian thực được mã hóa thông qua HTTP (RTMPTE) được sử dụng cho
phát trực tuyến nội dung đa phương tiện trong các yêu cầu HTTP tới tường lửa xuyên qua.

rtmpt
Giao thức nhắn tin thời gian thực thông qua HTTPS.

Giao thức nhắn tin thời gian thực được truyền qua HTTPS (RTMPTS) được sử dụng để phát trực tuyến
nội dung đa phương tiện trong HTTPS yêu cầu vượt qua tường lửa.

libsmbclient
libsmbclient cho phép một người thao tác tài nguyên mạng CIFS / SMB.

Cú pháp sau là bắt buộc.

smb: // [[domain:] người dùng [: password @]] server [/ share [/ path [/ file]]]

Giao thức này chấp nhận các tùy chọn sau.

thời gian chờ
Đặt thời gian chờ tính bằng mili giây của các hoạt động I / O socket được sử dụng bởi mức thấp cơ bản
hoạt động. Theo mặc định, nó được đặt thành -1, có nghĩa là thời gian chờ không được chỉ định.

cắt bớt
Cắt bớt các tệp hiện có khi ghi, nếu được đặt thành 1. Giá trị 0 ngăn việc cắt ngắn.
Giá trị mặc định là 1.

nhóm làm việc
Đặt nhóm làm việc được sử dụng để tạo kết nối. Theo mặc định nhóm làm việc không được chỉ định.

Để biết thêm thông tin, hãy xem:http://www.samba.org/>.

libsh
Giao thức truyền tệp an toàn qua libssh

Đọc từ hoặc ghi vào tài nguyên từ xa bằng giao thức SFTP.

Cú pháp sau là bắt buộc.

sftp: // [user [: password] @] server [: port] /path/to/remote/resource.mpeg

Giao thức này chấp nhận các tùy chọn sau.

thời gian chờ
Đặt thời gian chờ của các hoạt động I / O của ổ cắm được sử dụng bởi hoạt động cấp thấp bên dưới. Qua
mặc định nó được đặt thành -1, có nghĩa là thời gian chờ không được chỉ định.

cắt bớt
Cắt bớt các tệp hiện có khi ghi, nếu được đặt thành 1. Giá trị 0 ngăn việc cắt ngắn.
Giá trị mặc định là 1.

khóa_riêng
Chỉ định đường dẫn của tệp chứa khóa cá nhân để sử dụng trong quá trình ủy quyền. Qua
libssh mặc định tìm kiếm các khóa trong ~ / .ssh / thư mục.

Ví dụ: Phát một tệp được lưu trữ trên máy chủ từ xa.

ffplay sftp: // người dùng: password @ server_address: 22 / home / user / resource.mpeg

librtmp rtmp, rtmpe, rtmp, rtmpt, rtmpte
Giao thức nhắn tin thời gian thực và các biến thể của nó được hỗ trợ thông qua librtmp.

Yêu cầu sự hiện diện của tiêu đề librtmp và thư viện trong quá trình cấu hình. Bạn cần phải
định cấu hình rõ ràng bản dựng bằng "--enable-librtmp". Nếu được kích hoạt, điều này sẽ thay thế
giao thức RTMP bản địa.

Giao thức này cung cấp hầu hết các chức năng máy khách và một vài chức năng máy chủ cần thiết để hỗ trợ
RTMP, RTMP được đào trong HTTP (RTMPT), RTMP được mã hóa (RTMPE), RTMP qua SSL / TLS (RTMPS) và
các biến thể đường hầm của các loại mã hóa này (RTMPTE, RTMPTS).

Cú pháp bắt buộc là:

: // [: ] [/ ] [/ ]

Ở đâu rtmp_proto là một trong các chuỗi "rtmp", "rtmpt", "rtmpe", "rtmps", "rtmpte",
"rtmpts" tương ứng với từng biến thể RTMP và máy chủ, cổng, ứng dụng và đường chơi có
cùng ý nghĩa như được chỉ định cho giao thức gốc RTMP. lựa chọn chứa danh sách không gian-
các tùy chọn riêng biệt của biểu mẫu chính=val.

Xem trang hướng dẫn sử dụng librtmp (man 3 librtmp) để biết thêm thông tin.

Ví dụ: để truyền một tệp trong thời gian thực tới máy chủ RTMP bằng cách sử dụng ffmpeg:

ffmpeg -re -i myfile -f flv rtmp: // myserver / live / mystream

Để phát cùng một luồng bằng cách sử dụng ffplay:

ffplay "rtmp: // myserver / live / mystream live = 1"

rtp
Giao thức vận tải thời gian thực.

Cú pháp bắt buộc cho URL RTP là: rtp: //hostname[:cổng] [?tùy chọn=val...]

cổng chỉ định cổng RTP để sử dụng.

Các tùy chọn URL sau được hỗ trợ:

ttl =n
Đặt giá trị TTL (Time-To-Live) (chỉ dành cho phát đa hướng).

rtcpport =n
Đặt cổng RTCP từ xa thành n.

localrtpport =n
Đặt cổng RTP cục bộ thành n.

localrtcpport =n'
Đặt cổng RTCP cục bộ thành n.

pkt_size =n
Đặt kích thước gói tối đa (tính bằng byte) thành n.

kết nối = 0 | 1
Thực hiện "kết nối ()" trên ổ cắm UDP (nếu được đặt thành 1) hoặc không (nếu đặt thành 0).

nguồn =ip[,ip]
Liệt kê các địa chỉ IP nguồn được phép.

khối =ip[,ip]
Liệt kê các địa chỉ IP nguồn không được phép (bị chặn).

write_to_source = 0 | 1
Gửi các gói đến địa chỉ nguồn của gói nhận được mới nhất (nếu được đặt thành 1) hoặc đến một
địa chỉ từ xa mặc định (nếu được đặt thành 0).

localport =n
Đặt cổng RTP cục bộ thành n.

Đây là một tùy chọn không được dùng nữa. Thay thế, localrtpport nên được sử dụng.

Ghi chú quan trọng:

1. Nếu rtcpport không được đặt cổng RTCP sẽ được đặt thành giá trị cổng RTP cộng với 1.

2. Nếu localrtpport (cổng RTP cục bộ) không được đặt, bất kỳ cổng nào có sẵn sẽ được sử dụng cho
các cổng RTP và RTCP cục bộ.

3. Nếu localrtcpport (cổng RTCP cục bộ) không được đặt, nó sẽ được đặt thành cổng RTP cục bộ
giá trị cộng 1.

rtsp
Giao thức phát trực tuyến thời gian thực.

Về mặt kỹ thuật, RTSP không phải là một trình xử lý giao thức trong libavformat, nó là một trình xử lý dữ liệu (demuxer) và trình xử lý dữ liệu (muxer). Các
demuxer hỗ trợ cả RTSP bình thường (với dữ liệu được truyền qua RTP; điều này được sử dụng bởi ví dụ
Apple và Microsoft) và Real-RTSP (với dữ liệu được truyền qua RDT).

Muxer có thể được sử dụng để gửi một luồng bằng RTSP ANNOUNCE đến một máy chủ hỗ trợ nó
(hiện tại Darwin Streaming Server và Mischa Spiegelmock's
<https://github.com/revmischa/rtsp-server>).

Cú pháp bắt buộc cho url RTSP là:

rtsp: // [: ] /

Các tùy chọn có thể được thiết lập trên ffmpeg/ffplay dòng lệnh hoặc đặt trong mã qua "AVOption" s hoặc trong
"avformat_open_input".

Các tùy chọn sau được hỗ trợ.

ban đầu_pause
Không bắt đầu phát luồng ngay lập tức nếu được đặt thành 1. Giá trị mặc định là 0.

rtsp_transport
Đặt giao thức truyền tải RTSP.

Nó chấp nhận các giá trị sau:

udp Sử dụng UDP làm giao thức truyền tải thấp hơn.

tcp Sử dụng TCP (xen kẽ trong kênh điều khiển RTSP) làm phương tiện truyền tải thấp hơn
giao thức.

udp_multicast
Sử dụng đa hướng UDP làm giao thức truyền tải thấp hơn.

http
Sử dụng đường hầm HTTP làm giao thức truyền tải thấp hơn, rất hữu ích cho việc chuyển
proxy.

Nhiều giao thức truyền tải thấp hơn có thể được chỉ định, trong trường hợp đó chúng được thử một
tại một thời điểm (nếu thiết lập không thành công, thiết lập tiếp theo sẽ được thử). Đối với muxer, chỉ có
tcp và udp các tùy chọn được hỗ trợ.

rtsp_flags
Đặt cờ RTSP.

Các giá trị sau được chấp nhận:

bộ lọc_src
Chỉ chấp nhận các gói từ địa chỉ và cổng ngang hàng đã thương lượng.

nghe
Hoạt động như một máy chủ, lắng nghe kết nối đến.

thích_tcp
Trước tiên, hãy thử vận ​​chuyển TCP cho RTP, nếu TCP có sẵn dưới dạng truyền tải RTSP RTP.

Giá trị mặc định là không ai.

allow_media_types
Đặt loại phương tiện để chấp nhận từ máy chủ.

Các cờ sau được chấp nhận:

video
âm thanh
dữ liệu

Theo mặc định, nó chấp nhận tất cả các loại phương tiện.

cổng tối thiểu
Đặt cổng UDP cục bộ tối thiểu. Giá trị mặc định là 5000.

max_port
Đặt cổng UDP cục bộ tối đa. Giá trị mặc định là 65000.

thời gian chờ
Đặt thời gian chờ tối đa (tính bằng giây) để đợi các kết nối đến.

Giá trị -1 có nghĩa là vô hạn (mặc định). Tùy chọn này ngụ ý rtsp_flags đặt thành
nghe.

sắp xếp lại_queue_size
Đặt số lượng gói vào bộ đệm để xử lý các gói được sắp xếp lại.

kỳ quặc
Đặt thời gian chờ I / O socket TCP tính bằng micro giây.

user-agent
Ghi đè tiêu đề Tác nhân người dùng. Nếu không được chỉ định, nó sẽ mặc định là libavformat
chuỗi định danh.

Khi nhận dữ liệu qua UDP, trình giải mã sẽ cố gắng sắp xếp lại thứ tự các gói đã nhận (vì chúng
có thể đến không theo thứ tự, hoặc các gói có thể bị mất hoàn toàn). Điều này có thể được tắt bằng cách cài đặt
độ trễ giảm thông số tối đa bằng XNUMX (thông qua trường "max_delay" của AVFormatContext).

Khi xem các luồng Real-RTSP đa bit với ffplay, các luồng để hiển thị có thể
được chọn với "-vst" n và "-ast" n cho video và âm thanh tương ứng và có thể được bật
bay bằng cách nhấn "v" và "a".

Các ví dụ

Tất cả các ví dụ sau đây đều sử dụng ffplay và ffmpeg công cụ hơn nữa.

· Xem một luồng qua UDP, với độ trễ sắp xếp lại tối đa là 0.5 giây:

ffplay -max_delay 500000 -rtsp_transport udp rtsp: //server/video.mp4

· Xem một luồng được đào qua HTTP:

ffplay -rtsp_transport http rtsp: //server/video.mp4

· Gửi một luồng trong thời gian thực tới máy chủ RTSP để những người khác xem:

ffmpeg -re -i -f rtsp -muxdelay 0.1 rtsp: //server/live.sdp

· Nhận một luồng trong thời gian thực:

ffmpeg -rtsp_flags nghe -i rtsp: //ownaddress/live.sdp

sap
Giao thức thông báo phiên (RFC 2974). Về mặt kỹ thuật, đây không phải là một trình xử lý giao thức trong
libavformat, nó là một muxer và demuxer. Nó được sử dụng để báo hiệu các luồng RTP, bằng cách
thông báo SDP cho các luồng thường xuyên trên một cổng riêng biệt.

đàn bà

Cú pháp cho url SAP được cung cấp cho muxer là:

nhựa cây:// [: ] [? ]

Các gói RTP được gửi đến điểm đến trên cảng cổnghoặc đến cổng 5004 nếu không có cổng nào
được chỉ định. lựa chọn là một "&" - danh sách được phân tách. Các tùy chọn sau được hỗ trợ:

thông báo_addr =địa chỉ
Chỉ định địa chỉ IP đích để gửi thông báo tới. Nếu bị bỏ qua,
thông báo được gửi đến địa chỉ phát đa hướng thông báo SAP thường được sử dụng
224.2.127.254 (sap.mcast.net) hoặc ff0e :: 2: 7ffe nếu điểm đến là một địa chỉ IPv6.

tify_port =cổng
Chỉ định cổng để gửi thông báo, mặc định là 9875 nếu không được chỉ định.

ttl =ttl
Chỉ định thời gian tồn tại giá trị cho các thông báo và gói RTP, mặc định là 255.

same_port =0 | 1
Nếu được đặt thành 1, hãy gửi tất cả các luồng RTP trên cùng một cặp cổng. Nếu không (mặc định), tất cả
luồng được gửi trên các cổng duy nhất, với mỗi luồng trên một cổng cao hơn 2 số so với
Trước. VLC / Live555 yêu cầu điều này phải được đặt thành 1 để có thể nhận luồng.
Ngăn xếp RTP trong libavformat để nhận yêu cầu tất cả các luồng phải được gửi trên duy nhất
Cảng.

Các dòng lệnh ví dụ theo sau.

Để phát một luồng trên mạng con cục bộ, để xem trong VLC:

ffmpeg -re -i -f sap sap xep: //224.0.0.255? same_port = 1

Tương tự, để xem trong ffplay:

ffmpeg -re -i -f nhựa cây: //224.0.0.255

Và để xem trong ffplay, qua IPv6:

ffmpeg -re -i -f sap sap xep: // [ff0e :: 1: 2: 3: 4]

bộ giải mã

Cú pháp cho url SAP được cung cấp cho demuxer là:

nhựa cây://[ ] [: ]

địa chỉ là địa chỉ phát đa hướng để lắng nghe thông báo, nếu bị bỏ qua, là địa chỉ mặc định
224.2.127.254 (sap.mcast.net) được sử dụng. cổng là cổng được lắng nghe, 9875 nếu
bỏ qua.

Các demuxer lắng nghe các thông báo về địa chỉ và cổng đã cho. Một khi một
đã nhận được thông báo, nó sẽ cố gắng nhận luồng cụ thể đó.

Các dòng lệnh ví dụ theo sau.

Để phát lại luồng đầu tiên được thông báo trên địa chỉ phát đa hướng SAP thông thường:

ffplay sap: //

Để phát lại luồng đầu tiên được thông báo trên một địa chỉ phát đa hướng IPv6 SAP mặc định:

ffplay sap: // [ff0e :: 2: 7ffe]

sctp
Giao thức truyền điều khiển luồng.

Cú pháp URL được chấp nhận là:

sctp: // : [? ]

Giao thức chấp nhận các tùy chọn sau:

nghe
Nếu được đặt thành bất kỳ giá trị nào, hãy lắng nghe kết nối đến. Kết nối đi được thực hiện bởi
mặc định.

max_stream
Đặt số lượng luồng tối đa. Theo mặc định, không có giới hạn nào được thiết lập.

srtp
Giao thức truyền tải thời gian thực an toàn.

Các tùy chọn được chấp nhận là:

srtp_in_suite
srtp_out_suite
Chọn bộ mã hóa đầu vào và đầu ra.

Các giá trị được hỗ trợ:

AES_CM_128_HMAC_SHA1_80
SRTP_AES128_CM_HMAC_SHA1_80
AES_CM_128_HMAC_SHA1_32
SRTP_AES128_CM_HMAC_SHA1_32
srtp_in_params
srtp_out_params
Đặt các thông số mã hóa đầu vào và đầu ra, được thể hiện bằng mã hóa base64
biểu diễn của một khối nhị phân. 16 byte đầu tiên của khối nhị phân này được sử dụng làm
khóa chính, 14 byte sau được sử dụng làm muối chính.

hồ sơ con
Hầu như trích xuất một phân đoạn của một tệp hoặc một luồng khác. Luồng cơ bản phải là
có thể tìm kiếm được.

Các tùy chọn được chấp nhận:

Bắt đầu
Khoảng bù bắt đầu của phân đoạn được trích xuất, tính bằng byte.

cuối Phần bù cuối của phân đoạn được trích xuất, tính bằng byte.

Ví dụ:

Trích xuất một chương từ tệp DVD VOB (các khu vực bắt đầu và kết thúc được lấy từ bên ngoài và
nhân với 2048):

subfile ,, start, 153391104, end, 268142592 ,,: / media / dvd / VIDEO_TS / VTS_08_1.VOB

Phát tệp AVI trực tiếp từ kho lưu trữ TAR:

subfile ,, start, 183241728, end, 366490624 ,,: archive.tar

tcp
Giao thức điều khiển đường truyền.

Cú pháp bắt buộc cho url TCP là:

tcp: // : [? ]

lựa chọn chứa danh sách các tùy chọn & -separated của biểu mẫu chính=val.

Sau đây là danh sách các tùy chọn được hỗ trợ.

nghe =1 | 0
Nghe kết nối đến. Giá trị mặc định là 0.

thời gian chờ =micro giây
Đặt thời gian chờ lỗi tăng, được biểu thị bằng micro giây.

Tùy chọn này chỉ phù hợp trong chế độ đọc: nếu không có dữ liệu nào đến trong hơn thời gian này
khoảng thời gian, lỗi nâng cao.

nghe_timeout =mili giây
Đặt thời gian chờ nghe, được biểu thị bằng mili giây.

Ví dụ sau đây cho thấy cách thiết lập kết nối TCP lắng nghe với ffmpeg, Đó là
sau đó được truy cập bằng ffplay:

ffmpeg -i -NS tcp: // : ?nghe
ffplay tcp: // :

tls
Bảo mật lớp truyền tải (TLS) / Lớp cổng bảo mật (SSL)

Cú pháp bắt buộc cho url TLS / SSL là:

tls: // : [? ]

Các tham số sau có thể được đặt thông qua các tùy chọn dòng lệnh (hoặc trong mã thông qua "AVOption" s):

ca_file, cafile =tên tập tin
Tệp chứa các chứng chỉ gốc của tổ chức phát hành chứng chỉ (CA) để được coi là đáng tin cậy. Nếu như
thư viện TLS được liên kết chứa mặc định có thể không cần chỉ định cho
xác minh để hoạt động, nhưng không phải tất cả các thư viện và thiết lập đều có cài đặt mặc định.
tệp phải ở định dạng OpenSSL PEM.

tls_verify =1 | 0
Nếu được bật, hãy cố gắng xác minh đồng nghiệp mà chúng tôi đang giao tiếp. Lưu ý, nếu sử dụng
OpenSSL, điều này hiện chỉ đảm bảo rằng chứng chỉ ngang hàng được ký bởi một trong các
chứng chỉ gốc trong cơ sở dữ liệu CA, nhưng nó không xác thực rằng
chứng chỉ thực sự khớp với tên máy chủ mà chúng tôi đang cố gắng kết nối. (Với GnuTLS,
tên máy chủ cũng được xác thực.)

Điều này bị tắt theo mặc định vì nó yêu cầu cơ sở dữ liệu CA được cung cấp bởi
người gọi trong nhiều trường hợp.

chứng chỉ_file, cert =tên tập tin
Tệp có chứa chứng chỉ để sử dụng trong quá trình bắt tay với ngang hàng. (Khi nào
hoạt động như máy chủ, ở chế độ lắng nghe, điều này thường được đồng nghiệp yêu cầu nhiều hơn, trong khi
chứng chỉ ứng dụng khách chỉ được ủy quyền trong các thiết lập nhất định.)

tài liệu quan trọng, phím =tên tập tin
Tệp chứa khóa riêng tư cho chứng chỉ.

nghe =1 | 0
Nếu được bật, hãy lắng nghe các kết nối trên cổng được cung cấp và đảm nhận vai trò máy chủ trong
cái bắt tay thay vì vai trò khách hàng.

Các dòng lệnh ví dụ:

Để tạo máy chủ TLS / SSL phục vụ luồng đầu vào.

ffmpeg -i -NS tls: // : ? lắng nghe & cert = & key =

Để phát lại luồng từ máy chủ TLS / SSL bằng ffplay:

ffplay tls: // :

udp
Giao thức Datagram của Người dùng.

Cú pháp bắt buộc cho một URL UDP là:

udp: // : [? ]

lựa chọn chứa danh sách các tùy chọn & -separated của biểu mẫu chính=val.

Trong trường hợp luồng được bật trên hệ thống, một bộ đệm tròn được sử dụng để lưu trữ
dữ liệu đến, cho phép một trong những giảm mất dữ liệu do ghi đè bộ đệm ổ cắm UDP.
Sản phẩm Fifo_size và overrun_nonfatal các tùy chọn liên quan đến vùng đệm này.

Sau đây là danh sách các tùy chọn được hỗ trợ.

buffer_size =kích thước
Đặt kích thước bộ đệm ổ cắm tối đa UDP tính bằng byte. Điều này được sử dụng để đặt
nhận hoặc gửi kích thước bộ đệm, tùy thuộc vào ổ cắm được sử dụng để làm gì. Mặc định là
64KB. Xem thêm Fifo_size.

localport =cổng
Ghi đè cổng UDP cục bộ để liên kết với.

localaddr =địa chỉ
Chọn địa chỉ IP cục bộ. Điều này rất hữu ích, ví dụ: nếu gửi multicast và máy chủ có
nhiều giao diện, nơi người dùng có thể chọn giao diện để gửi
xác định địa chỉ IP của giao diện đó.

pkt_size =kích thước
Đặt kích thước tính bằng byte của gói UDP.

tái sử dụng =1 | 0
Cho phép hoặc không cho phép sử dụng lại ổ cắm UDP một cách rõ ràng.

ttl =ttl
Đặt thời gian thành giá trị trực tiếp (chỉ dành cho phát đa hướng).

kết nối =1 | 0
Khởi tạo ổ cắm UDP bằng "connect ()". Trong trường hợp này, địa chỉ đích
không thể thay đổi bằng ff_udp_set_remote_url sau này. Nếu địa chỉ đích không phải là
đã biết ngay từ đầu, tùy chọn này cũng có thể được chỉ định trong ff_udp_set_remote_url. Cái này
cho phép tìm ra địa chỉ nguồn cho các gói với getsockname và làm cho
ghi trả về bằng AVERROR (ECONNREFUSED) nếu nhận được "điểm đến không thể truy cập".
Đối với việc nhận, điều này mang lại lợi ích của việc chỉ nhận các gói từ
địa chỉ / cổng ngang hàng.

nguồn =địa chỉ[,địa chỉ]
Chỉ nhận các gói được gửi đến nhóm phát đa hướng từ một trong các IP người gửi được chỉ định
địa chỉ.

khối =địa chỉ[,địa chỉ]
Bỏ qua các gói được gửi đến nhóm phát đa hướng từ các địa chỉ IP của người gửi đã chỉ định.

Fifo_size =các đơn vị
Đặt kích thước bộ đệm tròn nhận UDP, được biểu thị bằng một số gói có kích thước
trên 188 byte. Nếu không được chỉ định, mặc định là 7 * 4096.

overrun_nonfatal =1 | 0
Sống sót trong trường hợp UDP nhận được tràn bộ đệm tròn. Giá trị mặc định là 0.

thời gian chờ =micro giây
Đặt thời gian chờ lỗi tăng, được biểu thị bằng micro giây.

Tùy chọn này chỉ phù hợp trong chế độ đọc: nếu không có dữ liệu nào đến trong hơn thời gian này
khoảng thời gian, lỗi nâng cao.

phát sóng =1 | 0
Cho phép hoặc không cho phép phát UDP một cách rõ ràng.

Xin lưu ý rằng tính năng phát sóng có thể không hoạt động bình thường trên các mạng đang có bão phát sóng
sự bảo vệ.

Các ví dụ

· Sử dụng ffmpeg để truyền trực tuyến qua UDP tới một điểm cuối từ xa:

ffmpeg -i -NS udp: // :

· Sử dụng ffmpeg phát trực tiếp ở định dạng mpegts qua UDP bằng cách sử dụng 188 gói UDP có kích thước, sử dụng
bộ đệm đầu vào lớn:

ffmpeg -i -f mpegts udp: // : ? pkt_size = 188 & buffer_size = 65535

· Sử dụng ffmpeg để nhận qua UDP từ một điểm cuối từ xa:

ffmpeg -i udp: // [ ]: ...

unix
Ổ cắm cục bộ Unix

Cú pháp bắt buộc cho URL ổ cắm Unix là:

unix: //

Các tham số sau có thể được đặt thông qua các tùy chọn dòng lệnh (hoặc trong mã thông qua "AVOption" s):

thời gian chờ
Thời gian chờ tính bằng mili giây.

nghe
Tạo ổ cắm Unix ở chế độ lắng nghe.

Sử dụng giao thức ffmpeg trực tuyến bằng các dịch vụ onworks.net