Bạn không bắt buộc phải ghi đè thông số luồng phát.
Bạn có thể sử dụng chế độ này nếu muốn trình phát hoặc ứng dụng ghi đè:
- Giá trị mặc định của thông số tạo luồng
- Thông tin lựa chọn hoặc trình tự mặc định của các biến thể khi danh sách phát HLS (Phát trực tuyến dựa trên HTTP) hoặc DASH (Truyền phát thích ứng động qua HTTP) được yêu cầu.
Bạn có thể chuyển các thông số này từ trình phát hoặc ứng dụng để triển khai IMA SDK, Đèn hiệu phía máy chủ (SSB) và API DAI.
Ghi đè thông tin lựa chọn và trình tự biến thể
Nhà xuất bản xác định trình tự danh sách phát mặc định. Nếu không có thông số trình tự nào được chỉ định, thì danh sách phát được trả về theo trình tự ban đầu mà nhà xuất bản sử dụng.
Bạn có thể ghi đè thông tin lựa chọn biến thể và các thông số trình tự đã chỉ định trong quá trình tạo luồng. Việc này giúp bạn chỉ định tập hợp các biến thể được đưa vào nội dung phản hồi cho một yêu cầu danh sách phát chính và xác định trình tự của những biến thể đó. Hành động này có thể hữu ích nếu bạn muốn ưu tiên một biến thể cụ thể hơn so với biến thể khác dựa trên người dùng sử dụng nội dung.
Tập hợp con và trình tự của các biến sẽ vẫn như cũ trong thời gian hoạt động của luồng. Thông số được chấp nhận dưới dạng một phần của cấu trúc adTagParameters khi sử dụng thông số IMA SDK, API DAI hoặc thông số GET
HTTP bổ sung khi sử dụng SSB.
Thông số | Giao thức truyền trực tuyến | Mô tả | Ví dụ |
---|---|---|---|
dai-aor |
HLS, DASH |
Phạm vi băng thông cho các biến thể âm thanh cần trả về.
|
|
dai-dlid |
HLS, DASH |
Khi bạn tạo cấu hình CDN cho thành phần video, hãy xác định cấu hình CDN mặc định và các chế độ phân phối CDN bổ sung. Điều này cho phép bạn thiết lập nhiều CDN và tự động chọn những gì bạn muốn phân phát từ đầu phiên bằng cách sử dụng khóa-giá trị. Sau khi bạn thiết lập và lưu tuỳ chọn định cấu hình CDN, Ad Manager sẽ gán tên cho mỗi CDN. Tên này nên được chuyển vào luồng tạo yêu cầu dưới dạng giá trị của thông số Nếu không có tên nào được truyền vào yêu cầu, thì Ad Manager sẽ sử dụng CDN mặc định. Lưu ý: |
( |
dai-excl |
HLS, DASH | Các nội dung hiển thị cần xóa khỏi danh sách phát. Hỗ trợ subtitles (phụ đề), codec (bộ mã hoá và giải mã), audio-lang (ngôn ngữ âm thanh), subtitle-lang (ngôn ngữ phụ đề), iframe và resolution (độ phân giải). Bạn có thể loại trừ độ phân giải, bộ mã hoá và giải mã âm thanh, bộ mã hoá và giải mã video, ngôn ngữ âm thanh và/hoặc ngôn ngữ phụ đề bằng cách sử dụng một giá trị duy nhất hoặc một danh sách gồm nhiều giá trị được phân tách bằng dấu phẩy. Tiền tố Codec cũng được hỗ trợ hậu tố "*", trong đó loại trừ tất cả các lần kết xuất bằng codec với tiền tố đã cho. |
Codec đơn Nhiều codec Bộ mã hoá và giải mã tiền tố Âm thanh của một ngôn ngữ duy nhất Phụ đề của một ngôn ngữ duy nhất Nhiều lựa chọn ngôn ngữ Độ phân giải |
dai-os |
HLS | Băng thông biến thể video cần đặt ở đầu danh sách phát chính. Biến thể có giá trị gần nhất với startBandwidth được chọn. Nếu hai giá trị là tương đương nhau, thì giá trị thấp nhất sẽ được chọn. Khi tham số này được cung cấp nhưng dai-aor không được cung cấp, thì tất cả biến thể chỉ có âm thanh đều bị loại trừ. |
dai-os=1700000 |
dai-ot |
HLS |
Thông tin loại trình tự, mô tả loại giá trị do thông số Nếu biến thể |
dai-ot=bw dai-ot=bw_res |
dai-ov |
HLS |
Các giá trị được phân tách bằng dấu phẩy chỉ định trình tự danh sách phát nội dung nghe nhìn sẽ được trả về. Cần sử dụng cùng với Nếu có nhiều biến thể có cùng giá trị trình tự (ví dụ: hai biến thể cùng băng thông nhưng độ phân giải khác nhau), trình tự ban đầu sẽ được duy trì trong những biến thể đó. |
|
dai-sr |
HLS, DASH |
Phạm vi băng thông cho các biến thể video cần trả về. Để chọn tất cả các băng thông cao hơn, bạn chỉ cần xác định Việc kiểm soát giới hạn băng thông chỉ áp dụng cho nội dung video.
|
dai-sr=1300000:2500000 |
Các thông số ghi đè khác
Thông số | Giao thức truyền trực tuyến | Mô tả | Ví dụ |
---|---|---|---|
dai-ah |
HLS, DASH | Chỉ định luồng trực tiếp có nên áp dụng thời lượng nghỉ quảng cáo hay không. Bạn phải chỉ định thời lượng nghỉ quảng cáo trong cấu hình luồng trực tiếp. | Bật thời lượng nghỉ quảng cáo:dai-ah=1 |
dai-apto (Phiên bản thử nghiệm beta) |
HLS, DASH |
Thời gian chờ quyết định nhóm quảng cáo cho VOD và buổi phát trực tiếp được tạo, tính bằng mili giây. Giá trị này được dùng cho tất cả các quyết định chặn quảng cáo tại thời điểm tạo sự kiện phát trực tuyến – quyết định chèn quảng cáo trong video và một lượt chèn quảng cáo trước đây đối với quảng cáo dạng tuyến tính, cũng như quyết định VMAP (Danh sách phát video nhiều quảng cáo) đối với nội dung VOD. Tuy nhiên, đối với các điểm chèn quảng cáo trước đây, giá trị này chỉ có sẵn khi sử dụng danh sách phát loại EVENT hoặc tham số dai-dpb. Giá trị này có thể được đặt thành giá trị bất kỳ lớn hơn 0 và nhỏ hơn hoặc bằng 10000.
Đặt giá trị rất thấp hoặc cao có thể ảnh hưởng đến việc lấp đầy quảng cáo hoặc trải nghiệm người dùng. |
dai-apto=4000 |
dai-dpb |
HLS, DASH |
Chỉ định có bật tính năng quyết định điểm chèn đi qua cho các luồng tuyến tính không phải SSB hay không (tham số này bị bỏ qua đối với các luồng SSB). Nếu bạn bật chế độ này, các điểm chèn đi qua sẽ được quyết định bằng quyết định điểm chèn trong luồng. Việc này có thể ảnh hưởng đến độ trễ khởi động mà bạn có thể kiểm soát bằng thông số Hệ thống sẽ không xem xét các điểm chèn trong quá khứ, trừ khi người dùng tua lại và việc này có thể làm tăng số lượt phân phát mã. |
Bật tính năng quyết định điểm chèn trong quá khứ:dai-dpb=true Tắt tính năng quyết định điểm chèn trong quá khứ cho danh sách phát loại EVENT HLS : dai-dpb=false |
dai-dvr |
HLS, DASH | Thời lượng DVR (tính bằng giây) của nội dung và quảng cáo trực tiếp mà người dùng có thể cuộn lại và duy trì phát lại liền mạch.
Giá trị mặc định hiện tại cho giá trị này là 100 giây hoặc giá trị được chỉ định trong quá trình thiết lập luồng trực tiếp. Tuy nhiên, bạn có thể chỉ định mức tối đa mới cho mỗi luồng trực tiếp, lên tới 100 giây đối với SSB hoặc 1800 giây khi sử dụng SDK hoặc API. Nếu bạn muốn thời lượng DVR lớn hơn, hãy liên hệ với người quản lý tài khoản của mình. Hướng dẫn và cách sử dụngThời lượng DVR thực tế của danh sách phát được trả về có thể hơi nhiều hoặc ít hơn tùy vào thời lượng của các phân đoạn cơ bản. Thời lượng đó cũng có thể hơi khác nhau giữa các biến thể. Giá trị tối đa của thời lượng thực tế không được lớn hơn giá trị thời lượng DVR chỉ định trong sự kiện. Nếu giá trị tối đa lớn hơn, thì hệ thống sẽ tự động giới hạn giá trị đó. Thời lượng DVR cho luồng SSB cũng được giới hạn ở giá trị thấp hơn so với luồng SDK hoặc API công khai. Mặc dù chúng tôi cố hết sức để trả về tệp kê khai tương thích, việc chỉ định giá trị rất nhỏ hoặc lớn có thể gây ra sự cố trong quá trình phát. Quá trình phát phải được kiểm tra kỹ với thời lượng DVR mong muốn để đảm bảo mọi thứ hoạt động đúng. Tránh sử dụng thời lượng khác nhau trên các thiết bị. Việc chỉ định mức thời lượng 30 giây cho một thiết bị và 31 giây hoặc 35 giây cho các thiết bị khác là không phù hợp về hiệu suất. Thay vào đó, hãy sử dụng các nhóm thời lượng (ví dụ: 35 giây cho một bộ thiết bị, 10 phút cho bộ khác, v.v.). Điều này cho phép hệ thống phân bổ tài nguyên và hiệu suất hiệu quả hơn. |
dai-dvr=60 |
dai-emsgv |
HLS |
Phiên bản Thông báo sự kiện (Event Message) là một thông số tạo luồng cho phép người gọi chỉ định phiên bản "emsg" cho nội dung ở Định dạng ứng dụng đa phương tiện chung (CMAF). Tiêu chuẩn HLS yêu cầu "emsg" phiên bản 1. Chế độ cài đặt này sẽ hữu ích cho các nền tảng không hỗ trợ phiên bản chuẩn 1 và cần phiên bản 0, chẳng hạn như Roku.
|
dai-emsgv=1 |
dai-pre (Phiên bản thử nghiệm beta) |
HLS, DASH | Chỉ định xem sự kiện phát trực tiếp đã bật quảng cáo trước video có nên hiển thị quảng cáo trước video thay vì trong video hay không, trong trường hợp các quảng cáo này trùng lặp. Chế độ mặc định cho thấy quảng cáo trùng lặp trong video thay vì quảng cáo trước video. | dai-pre=1 |
dai-ad-dlid (Phiên bản thử nghiệm beta) |
HLS, DASH |
Chỉ định tên duy nhất của một CDN bên ngoài mà bạn đã định cấu hình trước trong Google Ad Manager cho mục đích phân phối quảng cáo đến luồng phát trực tiếp. Tìm hiểu thêm về việc phân phối quảng cáo thông qua CDN bên ngoài. |
( |
dai-aup (Phiên bản thử nghiệm beta) |
HLS, DASH |
Chỉ định một tiền tố URL tuỳ ý trỏ đến một CDN bên ngoài dùng để tạo URL phân đoạn quảng cáo cho mục đích phân phối quảng cáo đến luồng phát trực tiếp. Tìm hiểu thêm về việc phân phối quảng cáo thông qua CDN bên ngoài. |
dai-aup=https://domain.com/path-c1/path-c2 |
Ví dụ về ghi đè thông số
Mở rộng tất cả Thu gọn tất cả
Yêu cầu
https://dai.google.com/linear/hls/event/<asset_key>/master.m3u8?dai-ot=bw&dai-ov=2025837,1406061
Phản hồi
#EXTM3U
#EXT-X-VERSION:3
#EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=2025837,RESOLUTION=960x540,CODECS="mp4a.40.2,avc1.4d401f"
https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/2025837.m3u8
#EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=1406061,RESOLUTION=640x360,CODECS="mp4a.40.2,avc1.4d401f"
https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/1406061.m3u8
Yêu cầu
https://dai.google.com/linear/hls/event/<asset_key>/master.m3u8?dai-ot=bw&dai-ov=audio,1406061
Phản hồi
#EXTM3U
#EXT-X-VERSION:3
#EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=64000,RESOLUTION=480x270,CODECS="mp4a.40.2"
https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/audio.m3u8
#EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=1406061,RESOLUTION=640x360,CODECS="mp4a.40.2,avc1.4d401f"
https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/1406061.m3u8
Yêu cầu
https://dai.google.com/linear/hls/event/<asset_key>/master.m3u8?dai-ot=bw_res&dai-ov=1400000:640x360,audio
Phản hồi
#EXTM3U
#EXT-X-VERSION:3
#EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=1406061,RESOLUTION=640x360,CODECS="mp4a.40.2,avc1.4d401f"
https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/1406061.m3u8
#EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=64000,RESOLUTION=480x270,CODECS="mp4a.40.2"
https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/audio.m3u8
Yêu cầu
https://dai.google.com/linear/hls/event/<asset_key>/master.m3u8?dai-sr=1300000:2500000&dai-aor=60000
Phản hồi
#EXTM3U
#EXT-X-VERSION:3
#EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=1406061,RESOLUTION=640x360,CODECS="mp4a.40.2,avc1.4d401f"
https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/1406061.m3u8
#EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=2025837,RESOLUTION=960x540,CODECS="mp4a.40.2,avc1.4d401f"
https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/2025837.m3u8
#EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=64000,RESOLUTION=480x270,CODECS="mp4a.40.2"
https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/audio.m3u8
Yêu cầu
https://dai.google.com/linear/hls/event/<asset_key>/master.m3u8?dai-os=1700000
Phản hồi
#EXTM3U
#EXT-X-VERSION:3
#EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=1406061,RESOLUTION=640x360,CODECS="mp4a.40.2,avc1.4d401f"
https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/1406061.m3u8
#EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=2025837,RESOLUTION=960x540,CODECS="mp4a.40.2,avc1.4d401f"
https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/2025837.m3u8
Tệp kê khai gốc có phụ đề
#EXTM3U
#EXT-X-VERSION:3
#EXT-X-MEDIA:TYPE=SUBTITLES,GROUP-ID="subs",LANGUAGE="en",NAME="English",AUTOSELECT=YES,URI="tt-en.m3u8"
#EXT-X-MEDIA:TYPE=SUBTITLES,GROUP-ID="subs",LANGUAGE="de",NAME="Deutsch",AUTOSELECT=YES,URI="tt-de.m3u8"
#EXT-X-MEDIA:TYPE=AUDIO,GROUP-ID="stereo",LANGUAGE="en",NAME="English",DEFAULT=YES,AUTOSELECT=YES,URI="audio.m3u8"
#EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=889549,RESOLUTION=640x360,CODECS="mp4a.40.2,avc1.4d401f" SUBTITLES="subs"
https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/889549.m3u8
#EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=1406061,RESOLUTION=640x360,CODECS="mp4a.40.2,avc1.4d401f" SUBTITLES="subs"
https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/2025837.m3u8
Yêu cầu
https://dai.google.com/linear/hls/event/<asset_key>/master.m3u8?dai-excl=subtitles
Phản hồi
#EXTM3U
#EXT-X-VERSION:3
#EXT-X-MEDIA:TYPE=AUDIO,GROUP-ID="stereo",LANGUAGE="en",NAME="English",DEFAULT=YES,AUTOSELECT=YES,URI="audio.m3u8"
#EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=889549,RESOLUTION=640x360,CODECS="mp4a.40.2,avc1.4d401f" SUBTITLES="subs"
https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/889549.m3u8
#EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=1406061,RESOLUTION=640x360,CODECS="mp4a.40.2,avc1.4d401f" SUBTITLES="subs"
https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/2025837.m3u8
Tệp kê khai gốc với ac-3, eac-3
#EXTM3U
#EXT-X-STREAM-INF:BANDWIDTH=6107776,RESOLUTION=1920x1080,CODECS="avc1.640028,ec-3",AUDIO="AUDIO-EAC3"
https://truman.com/ssai/hls/event/<event_code>/encoder/<encoder_id>/session/<session_id>/bandwidth/6107776.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=2212301,RESOLUTION=960x540,CODECS="avc1.640028,ec-3",AUDIO="AUDIO-EAC3"
https://truman.com/ssai/hls/event/<event_code>/encoder/<encoder_id>/session/<session_id>/bandwidth/2212301.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=6295776,RESOLUTION=1920x1080,CODECS="ac-3,avc1.640028",AUDIO="AUDIO-AC3"
https://truman.com/ssai/hls/event/<event_code>/encoder/<encoder_id>/session/<session_id>/bandwidth/6295776.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=2400301,RESOLUTION=960x540,CODECS="ac-3,avc1.640028",AUDIO="AUDIO-AC3"
https://truman.com/ssai/hls/event/<event_code>/encoder/<encoder_id>/session/<session_id>/bandwidth/2400301.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=6045381,RESOLUTION=1920x1080,CODECS="avc1.640028,mp4a.40.2",AUDIO="AUDIO-AAC"
https://truman.com/ssai/hls/event/<event_code>/encoder/<encoder_id>/session/<session_id>/bandwidth/6045381.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=2149906,RESOLUTION=960x540,CODECS="avc1.640028,mp4a.40.2",AUDIO="AUDIO-AAC"
https://truman.com/ssai/hls/event/<event_code>/encoder/<encoder_id>/session/<session_id>/bandwidth/2149906.m3u8
#EXT-X-MEDIA:TYPE=AUDIO,URI="audio-eac3.m3u8",GROUP-ID="AUDIO-EAC3",LANGUAGE="en",NAME="ENGLISH",AUTOSELECT=YES
#EXT-X-MEDIA:TYPE=AUDIO,URI="audio-ac3.m3u8",GROUP-ID="AUDIO-AC3",LANGUAGE="en",NAME="ENGLISH",AUTOSELECT=YES
#EXT-X-MEDIA:TYPE=AUDIO,URI="audio-aac.m3u8",GROUP-ID="AUDIO-AAC",LANGUAGE="en",NAME="ENGLISH",AUTOSELECT=YES
Loại trừ một codec
Yêu cầu
http://truman.com/ssai/event/<event_code>/master.m3u8?dai-excl=codec:ec-3
Phản hồi
#EXTM3U
#EXT-X-STREAM-INF:BANDWIDTH=6295776,RESOLUTION=1920x1080,CODECS="ac-3,avc1.640028",AUDIO="AUDIO-AC3"
https://truman.com/ssai/hls/event/<event_code>/encoder/<encoder_id>/session/<session_id>/bandwidth/6295776.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=2400301,RESOLUTION=960x540,CODECS="ac-3,avc1.640028",AUDIO="AUDIO-AC3"
https://truman.com/ssai/hls/event/<event_code>/encoder/<encoder_id>/session/<session_id>/bandwidth/2400301.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=6045381,RESOLUTION=1920x1080,CODECS="avc1.640028,mp4a.40.2",AUDIO="AUDIO-AAC"
https://truman.com/ssai/hls/event/<event_code>/encoder/<encoder_id>/session/<session_id>/bandwidth/6045381.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=2149906,RESOLUTION=960x540,CODECS="avc1.640028,mp4a.40.2",AUDIO="AUDIO-AAC"
https://truman.com/ssai/hls/event/<event_code>/encoder/<encoder_id>/session/<session_id>/bandwidth/2149906.m3u8
#EXT-X-MEDIA:TYPE=AUDIO,URI="audio-ac3.m3u8",GROUP-ID="AUDIO-AC3",LANGUAGE="en",NAME="ENGLISH",AUTOSELECT=YES
#EXT-X-MEDIA:TYPE=AUDIO,URI="audio-aac.m3u8",GROUP-ID="AUDIO-AAC",LANGUAGE="en",NAME="ENGLISH",AUTOSELECT=YES
Loại trừ nhiều codec
Yêu cầu
http://truman.com/ssai/event/<event_code>/master.m3u8?dai-excl=codec:ec-3,codec:ac-3
Phản hồi
#EXTM3U
#EXT-X-STREAM-INF:BANDWIDTH=6045381,RESOLUTION=1920x1080,CODECS="avc1.640028,mp4a.40.2",AUDIO="AUDIO-AAC"
https://truman.com/ssai/hls/event/<event_code>/encoder/<encoder_id>/session/<session_id>/bandwidth/6045381.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=2149906,RESOLUTION=960x540,CODECS="avc1.640028,mp4a.40.2",AUDIO="AUDIO-AAC"
https://truman.com/ssai/hls/event/<event_code>/encoder/<encoder_id>/session/<session_id>/bandwidth/2149906.m3u8
#EXT-X-MEDIA:TYPE=AUDIO,URI="audio-aac.m3u8",GROUP-ID="AUDIO-AAC",LANGUAGE="en",NAME="ENGLISH",AUTOSELECT=YES