با IMA DAI SDK شروع کنید

راه حل DAI مورد علاقه خود را انتخاب کنید

خدمات کامل DAI

این راهنما نحوه پخش جریان DAI را با استفاده از IMA CAF DAI SDK نشان می‌دهد. اگر می‌خواهید نمونه یکپارچه‌سازی کامل‌شده را مشاهده یا دنبال کنید، نمونه را دانلود کنید .

قبل از استفاده از این راهنما، حتماً با پروتکل گیرنده وب Chromecast Application Framework آشنا شوید. این راهنما سطح اولیه آشنایی با مفاهیم گیرنده CAF، مانند رهگیرهای پیام و اشیاء mediaInformation ، و همچنین آشنایی با استفاده از ابزار فرمان و کنترل Cast برای شبیه سازی فرستنده CAF را در نظر می گیرد.

برای استفاده از IMA DAI، باید یک حساب Ad Manager 360 داشته باشید. اگر حساب Ad Manager دارید، برای جزئیات بیشتر با مدیر حساب خود تماس بگیرید. برای کسب اطلاعات در مورد ثبت نام در Ad Manager، از مرکز راهنمای Ad Manager دیدن کنید.

برای کسب اطلاعات در مورد ادغام با سایر پلتفرم‌ها یا استفاده از کیت توسعه نرم‌افزارهای سمت سرویس گیرنده IMA، به کیت‌های توسعه نرم‌افزار تبلیغات رسانه‌ای تعاملی مراجعه کنید.

نمای کلی CAF DAI

پیاده سازی DAI با استفاده از IMA CAF DAI SDK شامل دو جزء اصلی است که در این راهنما نشان داده شده است:

  • StreamRequest : شیئی که یک درخواست جریان را به سرورهای تبلیغاتی Google تعریف می کند. درخواست های جریان در دو نوع اصلی وجود دارد:

    • LiveStreamRequest : یک کلید دارایی و یک کلید API اختیاری و همچنین سایر پارامترهای اختیاری را مشخص می کند.
    • VODStreamRequest : شناسه منبع محتوا ، شناسه ویدیو ، و یک کلید API اختیاری و همچنین سایر پارامترهای اختیاری را مشخص می کند.

  • StreamManager : شی‌ای که ارتباط بین جریان ویدئو و IMA DAI SDK را کنترل می‌کند، مانند شلیک پینگ‌های ردیابی و ارسال رویدادهای جریان به ناشر.

پیش نیازها

  • یک حساب Cast Developer Console با یک دستگاه آزمایشی ثبت‌شده.
  • یک برنامه گیرنده وب میزبانی شده که در Cast Developer Console شما ثبت شده است و می توان آن را برای میزبانی کد ارائه شده توسط این راهنما تغییر داد.
  • یک برنامه ارسال که برای استفاده از برنامه گیرنده وب شما پیکربندی شده است. این مثال از ابزار Cast Command and Control به عنوان فرستنده استفاده می کند.

اشیاء MediaInfo فرستنده را پیکربندی کنید

ابتدا، شی MediaInfo برنامه فرستنده خود را طوری پیکربندی کنید که شامل فیلدهای زیر باشد:

contentId یک شناسه منحصر به فرد برای این آیتم رسانه ای
contentUrl اگر DAI StreamRequest به هر دلیلی شکست بخورد، URL جریان بازگشتی بارگیری می شود
streamType برای پخش‌های زنده، این مقدار باید روی «LIVE» تنظیم شود. برای جریان‌های VOD، این مقدار باید روی «BUFFERED» تنظیم شود
customData assetKey فقط پخش زنده پخش زنده مورد بارگیری را شناسایی می کند
contentSourceId فقط جریان VOD. فید رسانه ای را که حاوی جریان درخواستی است شناسایی می کند.
videoId فقط جریان VOD. جریان درخواستی را در فید رسانه مشخص شده شناسایی می کند.
ApiKey یک کلید API اختیاری که می‌تواند برای بازیابی URL جریان از IMA DAI SDK مورد نیاز باشد
senderCanSkip یک مقدار بولی که به گیرنده اطلاع می دهد که آیا دستگاه فرستنده توانایی نمایش دکمه پرش را دارد یا خیر، که پشتیبانی از تبلیغات قابل پرش را ممکن می کند.

برای پیکربندی این مقادیر در ابزار فرمان و کنترل Cast، روی تب Load Media کلیک کنید و نوع درخواست بار سفارشی را روی LOAD تنظیم کنید. سپس داده های JSON در ناحیه متن را با یکی از اشیاء JSON زیر جایگزین کنید:

زنده

{
  "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"
}

VOD

{
  "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"
}

این شی درخواست بار سفارشی می تواند به گیرنده ارسال شود تا مراحل زیر را آزمایش کند.

یک گیرنده اصلی CAF ایجاد کنید

با پیروی از راهنمای گیرنده اصلی CAF SDK، یک گیرنده وب پایه ایجاد کنید.

کد گیرنده شما باید به شکل زیر باشد: 

<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>

IMA DAI SDK را وارد کنید و Player Manager را دریافت کنید

یک برچسب اسکریپت برای وارد کردن IMA DAI SDK برای CAF به گیرنده وب خود، درست پس از بارگیری اسکریپت CAF اضافه کنید. CAF DAI SDK همیشه سبز است، بنابراین نیازی به تنظیم نسخه خاصی نیست. سپس در تگ اسکریپت زیر، زمینه گیرنده و مدیر پخش را قبل از شروع گیرنده به صورت ثابت ذخیره کنید. 

<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>

IMA Stream Manager را راه اندازی کنید

مدیر جریان CAF DAI SDK را راه‌اندازی کنید. 

<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>

رهگیر پیام بار را ایجاد کنید

CAF DAI SDK از رهگیر بارگذاری پیام CAF برای درخواست استریم و جایگزینی URL محتوا با جریان نهایی DAI استفاده می کند. رهگیر پیام streamManager.requestStream() را فراخوانی می کند که تنظیم وقفه های تبلیغاتی، درخواست جریان و جایگزینی contentURL موجود را انجام می دهد.

فقط یک رهگیر پیام بارگیری می تواند وجود داشته باشد، بنابراین اگر برنامه شما به استفاده از رهگیر نیاز دارد، باید هر گونه عملکرد سفارشی را در همان پاسخ تماس بگنجانید. 

<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>

درخواست جریان را بسازید

برای تکمیل یکپارچه سازی CAF DAI، باید درخواست جریان خود را با استفاده از داده هایی که در شی mediaInfo از فرستنده گنجانده شده است، بسازید.

<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>

اکنون می‌توانید با استفاده از CAF DAI SDK Google، جریان‌های DAI را درخواست و پخش کنید. برای آشنایی با ویژگی‌های پیشرفته‌تر SDK، به سایر راهنماها مراجعه کنید یا نمونه برنامه‌های گیرنده ما را دانلود کنید .