Trang này được dịch bởi Cloud Translation API.

Bắt đầu sử dụng SDK IMA DAI

Chọn giải pháp DAI mà bạn quan tâm

DAI (Chèn quảng cáo động) đầy đủ dịch vụ

Hướng dẫn này minh hoạ cách phát một luồng DAI, sử dụng SDK IMA CAF DAI. Nếu bạn muốn xem hoặc làm theo quá trình tích hợp mẫu đã hoàn tất, hãy tải ví dụ xuống.

Trước khi sử dụng hướng dẫn này, hãy nhớ làm quen với giao thức Bộ thu trên web của Khung ứng dụng Chromecast. Hướng dẫn này giả định mức độ quen thuộc cơ bản với các khái niệm của bộ thu CAF, chẳng hạn như các đối tượng trình chặn tin nhắn và mediaInformation, cũng như mức độ quen thuộc với việc sử dụng công cụ Lệnh truyền và Điều khiển để mô phỏng một người gửi CAF.

Để sử dụng IMA DAI, bạn phải có tài khoản Ad Manager 360. Nếu bạn có tài khoản Ad Manager, hãy liên hệ với người quản lý tài khoản để biết thêm thông tin. Để biết thông tin về cách đăng ký Ad Manager, hãy truy cập vào Trung tâm trợ giúp Ad Manager.

Để biết thông tin về cách tích hợp với các nền tảng khác hoặc về cách sử dụng SDK phía máy khách IMA, hãy xem phần SDK quảng cáo trên phương tiện truyền thông tương tác.

Tổng quan về CAF DAI

Việc triển khai DAI bằng cách sử dụng SDK DAI của IMA CAF bao gồm hai thành phần chính như được minh hoạ trong hướng dẫn này:

StreamRequest: Một đối tượng xác định yêu cầu truyền trực tuyến đến các máy chủ quảng cáo của Google. Yêu cầu luồng có hai loại chính:
- LiveStreamRequest: chỉ định một Khoá tài sản và một khoá API (không bắt buộc) cũng như các tham số không bắt buộc khác.
- VODStreamRequest: Chỉ định một Mã nguồn nội dung, Mã video và một khoá API (không bắt buộc) cũng như các tham số không bắt buộc khác.
StreamManager: Một đối tượng xử lý hoạt động giao tiếp giữa luồng video và SDK IMA DAI, chẳng hạn như kích hoạt ping theo dõi và chuyển tiếp các sự kiện luồng đến nhà xuất bản.

Điều kiện tiên quyết

Tài khoản Cast Developer Console với một thiết bị thử nghiệm đã đăng ký.
Một ứng dụng nhận lưu trữ web được lưu trữ đã đăng ký với Cast Developer Console và có thể được sửa đổi để lưu trữ mã mà hướng dẫn này cung cấp.
Một ứng dụng gửi được định cấu hình để dùng ứng dụng web nhận của bạn. Ví dụ này sử dụng công cụ Điều khiển và Lệnh truyền làm người gửi.

Định cấu hình đối tượng MediaInfo của người gửi

Trước tiên, hãy định cấu hình đối tượng MediaInfo của ứng dụng gửi để bao gồm các trường sau:

`contentId`		Giá trị nhận dạng duy nhất của mục nội dung đa phương tiện này
`contentUrl`		URL luồng dự phòng sẽ tải nếu DAI StreamRequest không thành công vì bất kỳ lý do gì
`streamType`		Đối với sự kiện phát trực tiếp, giá trị này phải được đặt thành "LIVE". Đối với sự kiện phát trực tiếp VOD, giá trị này phải được đặt thành "BUFFERED"
`customData`	`assetKey`	Chỉ áp dụng cho sự kiện phát trực tiếp. Xác định sự kiện phát trực tiếp sẽ tải
	`contentSourceId`	Chỉ luồng VOD. Xác định nguồn cấp dữ liệu nội dung nghe nhìn chứa luồng được yêu cầu.
	`videoId`	Chỉ luồng VOD. Xác định luồng được yêu cầu trong nguồn cấp dữ liệu nội dung nghe nhìn đã chỉ định.
	`ApiKey`	Bạn có thể cần một khoá API không bắt buộc để truy xuất URL luồng từ SDK IMA DAI
	`senderCanSkip`	Giá trị boolean cho người nhận biết liệu thiết bị gửi có thể hiển thị nút bỏ qua hay không, cho phép hỗ trợ quảng cáo có thể bỏ qua

Để định cấu hình các giá trị này trong công cụ điều khiển và lệnh truyền, hãy nhấp vào thẻ Load Media (Tải nội dung nghe nhìn) rồi đặt loại yêu cầu tải tuỳ chỉnh thành LOAD. Sau đó, hãy thay thế dữ liệu JSON trong vùng văn bản bằng một trong các đối tượng JSON sau:

TRỰC TIẾP

{
  "media": {
    "contentId": "bbb",
    "contentUrl": "https://storage.googleapis.com/interactive-media-ads/media/bbb.m3u8",
    "streamType": "LIVE",
    "customData": {
      "assetKey": "sN_IYUG8STe1ZzhIIE_ksA",
      "ApiKey": "",
      "senderCanSkip": true
    }
  },
  "credentials": "testCredentials"
}

Video theo yêu cầu

{
  "media": {
    "contentId": "tos",
    "contentUrl": "https://storage.googleapis.com/interactive-media-ads/media/tos.m3u8",
    "streamType": "BUFFERED",
    "customData": {
      "contentSourceId": "2548831",
      "videoId": "tears-of-steel",
      "ApiKey": "",
      "senderCanSkip": true
    }
  },
  "credentials": "testCredentials"
}

Bạn có thể gửi đối tượng yêu cầu tải tuỳ chỉnh này đến dịch vụ nhận để kiểm thử các bước sau.

Tạo một bộ thu CAF cơ bản

Làm theo Hướng dẫn về bộ thu cơ bản của CAF SDK, hãy tạo một bộ thu web cơ bản.

Mã của bộ nhận sẽ có dạng như sau:

<html>
<head>
  <script type="text/javascript"
      src="//www.gstatic.com/cast/sdk/libs/caf_receiver/v3/cast_receiver_framework.js">
  </script>
</head>
<body>
  <cast-media-player></cast-media-player>
  <script>
    cast.framework.CastReceiverContext.getInstance().start();
  </script>
</body>
</html>

Nhập SDK IMA DAI và tải Trình quản lý trình phát

Thêm một thẻ tập lệnh để nhập SDK IMA DAI cho CAF vào bộ thu web của bạn, ngay sau khi tập lệnh tải CAF. SDK DAI CAF luôn cập nhật, vì vậy, không cần phải đặt một phiên bản cụ thể. Sau đó, trong thẻ tập lệnh tiếp theo, hãy lưu trữ ngữ cảnh của trình thu nhận và trình quản lý trình phát dưới dạng hằng số trước khi khởi động trình thu nhận.

<html>
<head>
  <script type="text/javascript"
      src="//www.gstatic.com/cast/sdk/libs/caf_receiver/v3/cast_receiver_framework.js"></script>
  <script src="//imasdk.googleapis.com/js/sdkloader/cast_dai.js"></script>
</head>
<body>
  <cast-media-player></cast-media-player>
  <script>
    const castContext = cast.framework.CastReceiverContext.getInstance();
    const playerManager = castContext.getPlayerManager();

    castContext.start();
  </script>
</body>
</html>

Khởi chạy Trình quản lý luồng IMA

Khởi chạy Trình quản lý luồng của SDK DAI CAF.

<html>
<head>
  <script type="text/javascript"
      src="//www.gstatic.com/cast/sdk/libs/caf_receiver/v3/cast_receiver_framework.js"></script>
  <script src="//imasdk.googleapis.com/js/sdkloader/cast_dai.js"></script>
</head>
<body>
  <cast-media-player></cast-media-player>
  <script>
    const castContext = cast.framework.CastReceiverContext.getInstance();
    const playerManager = castContext.getPlayerManager();
    const streamManager = new google.ima.cast.dai.api.StreamManager();

    castContext.start();
  </script>
</body>
</html>

Tạo trình chặn thông báo tải

SDK DAI CAF sử dụng trình chặn thông báo tải CAF để đưa ra các yêu cầu truyền trực tuyến và thay thế URL nội dung bằng luồng DAI cuối cùng. Trình chặn thông báo gọi streamManager.requestStream(). Quá trình này xử lý việc đặt điểm chèn quảng cáo, yêu cầu luồng và thay thế contentURL hiện có.

Bạn chỉ có thể sử dụng một trình chặn thông báo tải. Vì vậy, nếu ứng dụng của bạn cần sử dụng trình chặn, thì bạn cần tích hợp bất kỳ hàm tuỳ chỉnh nào vào cùng một lệnh gọi lại.

<html>
<head>
  <script type="text/javascript"
      src="//www.gstatic.com/cast/sdk/libs/caf_receiver/v3/cast_receiver_framework.js"></script>
  <script src="//imasdk.googleapis.com/js/sdkloader/cast_dai.js"></script>
</head>
<body>
  <cast-media-player></cast-media-player>
  <script>
    const castContext = cast.framework.CastReceiverContext.getInstance();
    const playerManager = castContext.getPlayerManager();
    const streamManager = new google.ima.cast.dai.api.StreamManager();

    const getStreamRequest = (request) => null;

    playerManager.setMessageInterceptor(
        cast.framework.messages.MessageType.LOAD, (request) => {
          return streamManager.requestStream(request, getStreamRequest(request))
              .then((request) => {
                this.broadcast('Stream request successful.');
                return Promise.resolve(request);
              })
              .catch((error) => {
                this.broadcast('Stream request failed.');
                return Promise.resolve(request);
              });
        });

    castContext.start();
  </script>
</body>
</html>

Tạo yêu cầu luồng

Để hoàn tất quá trình tích hợp DAI với CAF, bạn cần xây dựng yêu cầu phát trực tuyến bằng cách sử dụng dữ liệu có trong đối tượng mediaInfo từ người gửi.

<html>
<head>
  <script type="text/javascript"
      src="//www.gstatic.com/cast/sdk/libs/caf_receiver/v3/cast_receiver_framework.js"></script>
  <script src="//imasdk.googleapis.com/js/sdkloader/cast_dai.js"></script>
</head>
<body>
  <cast-media-player></cast-media-player>
  <script>
    const castContext = cast.framework.CastReceiverContext.getInstance();
    const playerManager = castContext.getPlayerManager();
    const streamManager = new google.ima.cast.dai.api.StreamManager();

    const getStreamRequest = (request) => {
      const imaRequestData = request.media.customData;
      let streamRequest = null;
      if (imaRequestData.assetKey) {
        // Live stream
        streamRequest = new google.ima.cast.dai.api.LiveStreamRequest();
        streamRequest.assetKey = imaRequestData.assetKey;
      } else if (imaRequestData.contentSourceId) {
        // VOD stream
        streamRequest = new google.ima.cast.dai.api.VODStreamRequest();
        streamRequest.contentSourceId = imaRequestData.contentSourceId;
        streamRequest.videoId = imaRequestData.videoId;
      }
      if (streamRequest && imaRequestData.ApiKey) {
        streamRequest.ApiKey = imaRequestData.ApiKey;
      }
      if (streamRequest && imaRequestData.senderCanSkip) {
        streamRequest.senderCanSkip = imaRequestData.senderCanSkip;
      }
      return streamRequest;
    };

    playerManager.setMessageInterceptor(
        cast.framework.messages.MessageType.LOAD, (request) => {
          return streamManager.requestStream(request, getStreamRequest(request))
              .then((request) => {
                return Promise.resolve(request);
              })
              .catch((error) => {
                this.broadcast('Stream request failed.');
                return Promise.resolve(request);
              });
        });

    castContext.start();
  </script>
</body>
</html>

Giờ đây, bạn có thể yêu cầu và phát các luồng DAI bằng SDK DAI CAF của Google. Để tìm hiểu thêm về các tính năng SDK nâng cao, hãy xem các hướng dẫn khác hoặc tải ứng dụng receiver mẫu của chúng tôi xuống.