কোডল্যাব: পুশ বিজ্ঞপ্তি ক্লায়েন্ট তৈরি করা

Kate Jeffreys
Kate Jeffreys
Kayce Basques
Kayce Basques

এই কোডল্যাব আপনাকে ধাপে ধাপে দেখায় যে কীভাবে একটি পুশ বিজ্ঞপ্তি ক্লায়েন্ট তৈরি করতে হয়। কোডল্যাবের শেষে আপনার কাছে এমন একটি ক্লায়েন্ট থাকবে যা:

  • ব্যবহারকারীকে পুশ বিজ্ঞপ্তির সাবস্ক্রিপশন দেয়।
  • পুশ মেসেজ পায় এবং বিজ্ঞপ্তি হিসেবে সেগুলি দেখায়।
  • ব্যবহারকারীকে পুশ বিজ্ঞপ্তি থেকে আনসাবস্ক্রাইব করে।

এই কোডল্যাব আপনাকে হাতে-কলমে শেখার ব্যাপারে সাহায্য করার উপর ফোকাস করে এবং কনসেপ্ট সম্পর্কে বেশি কিছু বলে না। পুশ বিজ্ঞপ্তির ধারণা সম্পর্কে জানতে পুশ কীভাবে কাজ করে তা পড়ুন।

এই কোডল্যাবের সার্ভার কোড আগে থেকেই সম্পূর্ণ। আপনি এই কোডল্যাবে শুধুমাত্র ক্লায়েন্ট ইমপ্লিমেন্ট করবেন। পুশ বিজ্ঞপ্তি সার্ভার কীভাবে প্রয়োগ করতে হয় তা জানতে, Codelab: পুশ বিজ্ঞপ্তি সার্ভার তৈরি করুন দেখুন।

মানানসই ব্রাউজার

এই কোডল্যাব নিম্নলিখিত অপারেটিং সিস্টেম ও ব্রাউজার কম্বিনেশনের সাথে কাজ করে বলে জানা গেছে:

  • Windows: Chrome, Edge
  • macOS: Chrome, Firefox
  • Android: Chrome, Firefox

এই কোডল্যাব নিম্নলিখিত অপারেটিং সিস্টেমের সাথে কাজ করে না বলে জানা গেছে (বা অপারেটিং সিস্টেম এবং ব্রাউজারের কম্বিনেশন):

  • macOS: Brave, Edge, Safari
  • iOS

সেটআপ

যাচাইকরণ সেট-আপ করা

পুশ বিজ্ঞপ্তি কাজ করার আগে, আপনাকে যাচাইকরণ কী দিয়ে আপনার সার্ভার এবং ক্লায়েন্ট সেট-আপ করতে হবে। কারণ জানতে আপনার ওয়েব পুশ প্রোটোকল অনুরোধে সাইন করুন দেখুন। সাধারণত, আপনি .env ফাইলে সিক্রেট স্টোর করেন, ঠিক এটির মতো।

VAPID_PUBLIC_KEY="BKiwTvD9HA…"
VAPID_PRIVATE_KEY="4mXG9jBUaU…"
VAPID_SUBJECT="mailto:test@test.test"
  1. public/index.js খুলুন।
  2. VAPID_PUBLIC_KEY_VALUE_HERE-এর জায়গায় আপনার পাবলিক কী-এর ভ্যালু লিখুন।

সার্ভিস ওয়ার্কার রেজিস্টার করা

বিজ্ঞপ্তি পেতে ও দেখাতে আপনার ক্লায়েন্টের একজন সার্ভিস ওয়ার্কার প্রয়োজন। যত তাড়াতাড়ি সম্ভব সার্ভিস ওয়ার্কার রেজিস্টার করা সবচেয়ে ভালো। আরও প্রসঙ্গের জন্য পুশ মেসেজ বিজ্ঞপ্তি হিসেবে রিসিভ ও ডিসপ্লে করুন দেখুন।

  1. // TODO add startup logic here কমেন্টটি নিম্নলিখিত কোড দিয়ে পরিবর্তন করুন:

    if ('serviceWorker' in navigator && 'PushManager' in window) {
      navigator.serviceWorker.register('./service-worker.js').then(serviceWorkerRegistration => {
        console.info('Service worker was registered.');
        console.info({serviceWorkerRegistration});
      }).catch(error => {
        console.error('An error occurred while registering the service worker.');
        console.error(error);
      });
      subscribeButton.disabled = false;
    } else {
      console.error('Browser does not support service workers or push messages.');
    }
    
    subscribeButton.addEventListener('click', subscribeButtonHandler);
    unsubscribeButton.addEventListener('click', unsubscribeButtonHandler);
    
  2. Chrome-এ, DevTools Console খুলুন।

  3. আপনি কনসোলে Service worker was registered. মেসেজটি লগ করা দেখতে পাবেন।

পুশ বিজ্ঞপ্তির অনুমতি দেওয়ার অনুরোধ

পৃষ্ঠা লোড হওয়ার সময় পুশ বিজ্ঞপ্তি পাঠানোর অনুমতি কখনও চাইবেন না। পরিবর্তে, আপনার UI-এর উচিত ব্যবহারকারীকে জিজ্ঞাসা করা যে তিনি পুশ বিজ্ঞপ্তি পেতে চান কিনা। তারা স্পষ্টভাবে কনফার্ম করার পরে (যেমন, বোতামে ক্লিক করে) আপনি ব্রাউজার থেকে পুশ বিজ্ঞপ্তির অনুমতি পাওয়ার জন্য আনুষ্ঠানিক প্রসেস শুরু করতে পারবেন।

  1. public/index.js-এ // TODO কমেন্টটি subscribeButtonHandler()-এ নিম্নলিখিত কোড দিয়ে প্রতিস্থাপন করুন:

    // Prevent the user from clicking the subscribe button multiple times.
    subscribeButton.disabled = true;
    const result = await Notification.requestPermission();
    if (result === 'denied') {
      console.error('The user explicitly denied the permission request.');
      return;
    }
    if (result === 'granted') {
      console.info('The user accepted the permission request.');
    }
    
  2. অ্যাপ ট্যাবে ফিরে যান এবং পুশ করার জন্য সাবস্ক্রাইব করুন বিকল্পে ক্লিক করুন। আপনি ওয়েবসাইটকে পুশ বিজ্ঞপ্তি পাঠানোর অনুমতি দিতে চান কিনা তা আপনার ব্রাউজার বা অপারেটিং সিস্টেম জিজ্ঞাসা করবে।

  3. অনুমতি দিন (অথবা আপনার ব্রাউজার বা অপারেটিং সিস্টেমের দ্বারা ব্যবহৃত সমতুল্য বাক্যাংশ) বিকল্প বেছে নিন। অনুরোধটি গৃহীত বা প্রত্যাখ্যাত হয়েছে কিনা তা নির্দেশ করে কনসোলে আপনার একটি মেসেজ দেখা উচিত।

পুশ বিজ্ঞপ্তির জন্য সাবস্ক্রাইব করুন

সাবস্ক্রিপশন প্রসেস ব্রাউজার ভেন্ডর দ্বারা নিয়ন্ত্রিত ওয়েব পরিষেবার সাথে ইন্টার‍্যাক্ট করে, যাকে পুশ পরিষেবা বলা হয়। পুশ বিজ্ঞপ্তির সাবস্ক্রিপশন সংক্রান্ত তথ্য পাওয়ার পরে আপনাকে সেটি সার্ভারে পাঠাতে হবে এবং সার্ভারকে সেটি ডেটাবেসে দীর্ঘমেয়াদী ভিত্তিতে স্টোর করতে হবে।

  1. subscribeButtonHandler()-এ নিম্নলিখিত হাইলাইট করা কোড যোগ করুন:

    subscribeButton.disabled = true;
    const result = await Notification.requestPermission();
    if (result === 'denied') {
      console.error('The user explicitly denied the permission request.');
      return;
    }
    if (result === 'granted') {
      console.info('The user accepted the permission request.');
    }
    const registration = await navigator.serviceWorker.getRegistration();
    const subscribed = await registration.pushManager.getSubscription();
    if (subscribed) {
      console.info('User is already subscribed.');
      notifyMeButton.disabled = false;
      unsubscribeButton.disabled = false;
      return;
    }
    const subscription = await registration.pushManager.subscribe({
      userVisibleOnly: true,
      applicationServerKey: urlB64ToUint8Array(VAPID_PUBLIC_KEY)
    });
    notifyMeButton.disabled = false;
    fetch('/add-subscription', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json'
      },
      body: JSON.stringify(subscription)
    });
    

userVisibleOnly বিকল্পটি অবশ্যই true হতে হবে। ব্যবহারকারীকে দৃশ্যমান বিজ্ঞপ্তি না দেখিয়েই মেসেজ পুশ করা হয়ত একদিন সম্ভব হবে (সাইলেন্ট পুশ) কিন্তু গোপনীয়তা সংক্রান্ত উদ্বেগের কারণে ব্রাউজার সেই সুবিধা দেয় না।

applicationServerKey ভ্যালু একটি ইউটিলিটি ফাংশনের উপর নির্ভর করে যা base64 স্ট্রিংকে Uint8Array-তে কনভার্ট করে। আপনার সার্ভার ও পুশ পরিষেবার মধ্যে যাচাইকরণের জন্য এই ভ্যালু ব্যবহার করা হয়।

পুশ বিজ্ঞপ্তি থেকে আনসাবস্ক্রাইব করুন

ব্যবহারকারী পুশ বিজ্ঞপ্তির জন্য সাবস্ক্রাইব করার পরে, আপনার UI-তে আনসাবস্ক্রাইব করার উপায় প্রদান করতে হবে যাতে ব্যবহারকারী তার সিদ্ধান্ত পরিবর্তন করলে এবং পুশ বিজ্ঞপ্তি আর পেতে না চাইলে তা করতে পারেন।

  • unsubscribeButtonHandler()-এ // TODO কমেন্টটি নিম্নলিখিত কোড দিয়ে পরিবর্তন করুন:
const registration = await navigator.serviceWorker.getRegistration();
const subscription = await registration.pushManager.getSubscription();
fetch('/remove-subscription', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({endpoint: subscription.endpoint})
});
const unsubscribed = await subscription.unsubscribe();
if (unsubscribed) {
  console.info('Successfully unsubscribed from push notifications.');
  unsubscribeButton.disabled = true;
  subscribeButton.disabled = false;
  notifyMeButton.disabled = true;
}

পুশ মেসেজ পাওয়া এবং বিজ্ঞপ্তি হিসেবে তা দেখানো

আগে যেমন উল্লেখ করা হয়েছে, আপনার সার্ভার থেকে ক্লায়েন্টের কাছে পুশ করা মেসেজ রিসিভ ও দেখানোর জন্য আপনার একজন সার্ভিস ওয়ার্কার প্রয়োজন। আরও বিবরণের জন্য পুশ মেসেজ বিজ্ঞপ্তি হিসেবে রিসিভ ও ডিসপ্লে করুন বিকল্প দেখুন।

  1. public/service-worker.js খুলুন এবং পরিষেবা কর্মীর push ইভেন্ট হ্যান্ডলারে // TODO কমেন্টটি নিম্নলিখিত কোড দিয়ে প্রতিস্থাপন করুন:

    let data = event.data.json();
    const image = 'logo.png';
    const options = {
      body: data.options.body,
      icon: image
    }
    self.registration.showNotification(
      data.title,
      options
    );
    
  2. অ্যাপ ট্যাবে ফিরে যান।

  3. আমাকে বিজ্ঞপ্তি পাঠান বিকল্পে ক্লিক করুন। আপনি একটি পুশ বিজ্ঞপ্তি পাবেন।

  4. অন্যান্য কাজ করে এমন ব্রাউজারে আপনার অ্যাপ ট্যাবের URL খুলুন। সাবস্ক্রিপশন ওয়ার্কফ্লো দেখে নিয়ে সবাইকে বিজ্ঞপ্তি পাঠান বিকল্পে ক্লিক করুন। আপনি প্রত্যেকটিতে একই পুশ বিজ্ঞপ্তি পাবেন।

আপনি বিভিন্ন উপায়ে বিজ্ঞপ্তি কাস্টমাইজ করতে পারবেন। আরও জানতে ServiceWorkerRegistration.showNotification()-এর প্যারামিটার দেখুন।

ব্যবহারকারী কোনও বিজ্ঞপ্তিতে ক্লিক করলে URL খুলুন

বাস্তবে, আপনি সম্ভবত ব্যবহারকারীকে আবার এনগেজ করতে এবং আপনার সাইট দেখার জন্য প্রম্পট করতে বিজ্ঞপ্তি ব্যবহার করবেন। এটি করতে, আপনাকে নিজের সার্ভিস ওয়ার্কার আরও একটু কনফিগার করতে হবে।

  1. সার্ভিস ওয়ার্কারের notificationclick ইভেন্ট হ্যান্ডলারে // TODO কমেন্টটি নিম্নলিখিত কোড দিয়ে পরিবর্তন করুন:

    event.notification.close();
    event.waitUntil(self.clients.openWindow('https://web.dev'));
    
  2. অ্যাপ ট্যাবে ফিরে যান, নিজেকে আরেকটি বিজ্ঞপ্তি পাঠান এবং তারপরে বিজ্ঞপ্তিতে ক্লিক করুন। আপনার ব্রাউজারে নতুন ট্যাব খুলে https://web.dev লোড হওয়া উচিত।

পরবর্তী ধাপ