Omówienie transmisji na żywo
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Interfejs Pod Wyświetlanie API zapewnia dostęp do bloków reklam wideo z adaptacyjną szybkością transmisji bitów, przygotowanych w taki sposób, że można je połączyć bezpośrednio z widoczną dla użytkowników playlistą multimediów HLS lub MPEG DASH.
Ten interfejs API jest przeznaczony dla zaawansowanych wydawców i partnerów oferujących technologie wideo.
Używanie tego interfejsu API na dużą skalę wymaga zaprojektowania i wdrożenia złożonego procesu wyświetlania multimediów, który nie jest objęty tą dokumentacją.
Wymagania wstępne
Zanim przetworzysz transmisję na żywo za pomocą interfejsu DAI – API, musisz utworzyć wydarzenie transmisji na żywo w interfejsie Google Ad Managera lub interfejsie API wydarzenia na żywo.
Komponenty
Na każdą implementację interfejsu API do wyświetlania bloków składają się 3 komponenty: Google Ad Manager, odtwarzacz wideo klienta i serwer do manipulacji plikami manifestu.
Ad Manager
Za wyświetlanie reklam użytkownikom odpowiada Ad Manager. Możesz nim zarządzać za pomocą pakietu SDK Ad Managera lub interfejsu internetowego. Usługa jest odpowiedzialna za:
- Odbieranie żądań strumienia z odtwarzacza klienckiego,
podejmowanie decyzji o reklamach i dostarczanie odwzorowania dopasowanych do profili kodowania treści
- Odpowiadanie na żądania segmentów reklam z odtwarzacza wideo klienta i dostarczanie odpowiedniej części bloku reklamowego danemu użytkownikowi.
- Odbieranie i przetwarzanie pingów śledzenia z odtwarzacza wideo klienta
Odtwarzacz wideo klienta
Odtwarzacz wideo to aplikacja lub witryna, której klient używa do odtwarzania wywołanego strumienia wideo. Gracz ma następujące obowiązki:
- Inicjowanie zasobu strumienia z Ad Managera i odbieranie obiektu strumienia reprezentującego pojedynczą sesję odtwarzania konkretnego zdarzenia transmisji na żywo.
- Żądając pliku manifestu strumienia do serwera manipulacji plikami manifestu,
co powoduje rozpoczęcie odtwarzania.
- okresowe odpytywanie z Ad Managera metadanych bloku reklamowego, które opisują zdarzenia reklamowe umieszczone w segmentach reklam w strumieniu.
- Nasłuchiwanie zdarzeń metadanych ograniczonych czasowo, które zawierają identyfikatory mediów reklamowych zgłoszone przez odtwarzacz. Po wykryciu tych zdarzeń odtwarzacz przekazuje je do Ad Managera, aby sprawdzić, czy zdarzenia reklamowe wystąpiły.
Więcej informacji o prawidłowej implementacji odtwarzacza wideo klienta znajdziesz w przewodniku wyświetlania bloków reklamowych na Twojej platformie:
Informacje o niestandardowych implementacjach znajdziesz w przewodniku po interfejsie DAI API w przewodniku dla klienta wyświetlania bloków reklamowych.
Serwer manipulacji plikiem manifestu
Serwer manipulacji plikiem manifestu to serwer, który hostuje plik manifestu strumienia dostarczany do odtwarzacza wideo klienta. Serwer ma te obowiązki:
- Przesyłanie pliku manifestu do odtwarzacza wideo klienta
- Żądanie szablonu okresu do Ad Managera (tylko w przypadku strumieni MPEG DASH) w celu wypełnienia segmentów reklam.
- Podczas przerw na reklamy wstawiaj adresy URL segmentów reklam hostowane w usłudze Ad Manager do pliku manifestu strumienia wideo (w przypadku HLS) lub do okresu reklamy (w przypadku MPEG DASH).
- Wyświetlam zmodyfikowany plik manifestu w odtwarzaczu wideo klienta.
Więcej informacji o implementowaniu niestandardowego serwera manipulatora pliku manifestu znajdziesz w przewodniku po manipulacji plikami manifestu.
Glosariusz
- Zdarzenie transmisji na żywo: zdarzenie przechowujące ważne dane konfiguracji transmisji na żywo, np. profile kodujące. Wydarzenia z transmisją na żywo można tworzyć za pomocą Ad Managera.
- Obiekt strumienia: obiekt reprezentujący pojedynczą sesję odtwarzania konkretnego zasobu wideo. Najważniejsze właściwości to identyfikator strumienia i adres URL do weryfikacji multimediów.
- Blok reklamowy: grupowanie filmów z reklamami wyświetlanych w przerwie na reklamę.
- Segmenty reklam: pliki segmentów multimediów na potrzeby przerwy na reklamę.
- Metadane bloku reklamowego: metadane przerwy na reklamę używanej do renderowania interfejsu reklamy w kliencie, np. ukrywanie przycisków przewijania podczas wyświetlania reklamy.
- Identyfikator mediów reklamy: metadane zakodowane jako tagi ID3 w plikach segmentów reklam. Te metadane służą do określania, kiedy podczas odtwarzania wystąpiły określone zdarzenia związane z reklamą, np. początek lub połowa reklamy.
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-08-01 UTC.
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 2025-08-01 UTC."],[[["\u003cp\u003eThe Pod Serving API facilitates the integration of adaptive-bitrate video ad pods directly into HLS or MPEG DASH media playlists for advanced publishers and video technology partners.\u003c/p\u003e\n"],["\u003cp\u003eImplementing the Pod Serving API involves three core components: Google Ad Manager, which handles ad delivery and tracking; a client video player, which manages stream initialization and playback; and a manifest manipulation server, which modifies and serves the stream manifest.\u003c/p\u003e\n"],["\u003cp\u003eBefore using the API, a livestream event must be created via the Google Ad Manager UI or the live-event API, serving as a configuration resource for the livestream.\u003c/p\u003e\n"],["\u003cp\u003eThe client video player is responsible for initializing the stream, requesting the manifest, polling for ad pod metadata, and forwarding timed metadata events to Ad Manager.\u003c/p\u003e\n"],["\u003cp\u003eThe manifest manipulation server handles manifest delivery, requests ad period templates, and inserts Ad Manager-hosted ad segment URLs or ad periods into the stream manifest during ad breaks.\u003c/p\u003e\n"]]],[],null,["# Overview for live streams\n\nThe Pod Serving API provides access to adaptive-bitrate video ad pods prepared\nin such a way that they can be stitched directly into a user-facing HLS or MPEG\nDASH media playlist.\n\nThis API is intended for advanced publishers and video technology partners.\nUsing this API at scale requires design and implementation of a sophisticated\nmedia serving workflow which is outside the scope of this documentation.\n\nPrerequisites\n-------------\n\nBefore processing a livestream through the DAI Podserving API, you\nwill need to create a\n[livestream event](/ad-manager/dynamic-ad-insertion/api/pod-serving/live/manipulator#livestreamevent)\nusing the Google Ad Manager UI, or the live-event API.\n\nComponents\n----------\n\nThere are three components that make up any implementation of the Pod Serving\nAPI: Google Ad Manager, a client video player, and a manifest manipulation\nserver.\n\n### Ad Manager\n\nAd Manager is responsible for delivering ads to the user and can be managed\nthrough either the Ad Manager SDK or its web interface. The service has these\nresponsibilities:\n\n- Receiving stream requests from the client video player, decisioning ads, and providing renditions to match your content encoding profiles\n- Responding to ad segment requests from the client video player and providing the appropriate portion of the ad pod for the given user\n- Receiving and processing tracking pings from the client video player\n\n### Client video player\n\nThe client video player is the app or website that clients use to play the\nresulting video stream. The player has these responsibilities:\n\n- Initializing a stream resource from Ad Manager and receiving a stream object that represents a single playback session of a specific livestream event.\n- Requesting a stream manifest from the manifest manipulation server, which starts playback\n- Periodically polling ad pod metadata from Ad Manager that describes the ad events embedded in the stream's ad segments\n- Listening for timed metadata events raised by the player that contain ad media IDs. Upon encountering these events, the player forwards them to Ad Manager to verify that ad events have successfully occurred.\n\nTo learn more about the proper implementation of the client video player, see\nthe pod serving guide for your platform:\n\n- [Android](/ad-manager/dynamic-ad-insertion/sdk/android?service=pod)\n- [HTML5](/ad-manager/dynamic-ad-insertion/sdk/html5?service=pod)\n- [iOS](/ad-manager/dynamic-ad-insertion/sdk/ios?service=pod)\n- [tvOS](/ad-manager/dynamic-ad-insertion/sdk/tvos?service=pod)\n\nFor custom implementations, see our [pod serving client guide for the DAI\nAPI](/ad-manager/dynamic-ad-insertion/api/pod-serving/live/client).\n\n### Manifest manipulation server\n\nThe manifest manipulation server is the server in charge of hosting the\nstream manifest provided to the client video player. The server has these\nresponsibilities:\n\n- Handling manifest delivery to the client video player\n- Requesting a period template from Ad Manager (for MPEG DASH streams only), to populate with ad segments.\n- Inserting Ad Manager-hosted ad segment URLs into the video stream manifest (for HLS) or ad period (for MPEG DASH) during ad breaks.\n- Serving the modified manifest to the client video player.\n\nTo learn more about implementing a custom manifest manipulator server, see the\n[manifest manipulation\nguide](/ad-manager/dynamic-ad-insertion/api/pod-serving/live/manipulator).\n\nGlossary\n--------\n\n- **Livestream event**: An event that stores important configuration data for livestream, such as encoding profiles. Livestream events are created using Ad Manager.\n- **Stream object**: An object that represents a single playback session of a specific video asset. Notable properties include the stream ID and the media verification URL.\n- **Ad pod**: Grouping of ad videos shown in an ad break\n- **Ad segments**: Media segment files for the ad break\n- **Ad pod metadata**: Metadata for the ad break used to render ad UI on the client; for example, hide seek buttons during ad\n- **Ad media ID**: Metadata encoded as ID3 tags within ad segment files. This metadata is used to identify when specific ad-related events have occurred during playback, such as ad start or midpoint."]]
