iOS লাইভ অ্যাক্টিভিটিজ API

Apple ডকুমেন্টেশন:

• লাইভ অ্যাক্টিভিটিজ সম্পর্কে
• অ্যাক্টিভিটি কিট পুশ নোটিফিকেশন দিয়ে লাইভ অ্যাক্টিভিটিজ আপডেট এবং শেষ করা

startLiveActivity

POST https://api.pushwoosh.com/json/1.3/startLiveActivity

iOS লাইভ অ্যাক্টিভিটিজ তৈরি করার অনুমতি দেয়।

রিকোয়েস্ট বডি

প্যারামিটার	টাইপ	প্রয়োজনীয়/ঐচ্ছিক	বর্ণনা
application	String	প্রয়োজনীয়	Pushwoosh অ্যাপ্লিকেশন কোড
auth	String	প্রয়োজনীয়	Pushwoosh কন্ট্রোল প্যানেল থেকে API অ্যাক্সেস টোকেন।
notifications	Array	প্রয়োজনীয়	মেসেজ প্যারামিটারের JSON অ্যারে। নিচের নোটিফিকেশন টেবিলে বিস্তারিত দেখুন।

নোটিফিকেশন

notifications অ্যারেতে ব্যবহৃত প্যারামিটার:

প্যারামিটার	টাইপ	প্রয়োজনীয়/ঐচ্ছিক	বর্ণনা
content	String	প্রয়োজনীয়	iOS 16.1-এর নিচের ভার্সন চালিত ডিভাইসগুলির জন্য ফলব্যাক কন্টেন্ট, যা লাইভ অ্যাক্টিভিটি সাপোর্ট করে না। iOS 16.1+ (লাইভ অ্যাক্টিভিটি সাপোর্ট সহ) ডিভাইসে, কন্টেন্ট live_activity ফিল্ড থেকে নেওয়া হয়।
title	String	ঐচ্ছিক	নোটিফিকেশন মেসেজের টাইটেল।
live_activity	Object	প্রয়োজনীয়	iOS-এ লাইভ অ্যাক্টিভিটি তৈরি করার জন্য লাইভ অ্যাক্টিভিটি ডেটা।
live_activity.content-state	Object	প্রয়োজনীয়	লাইভ অ্যাক্টিভিটি নোটিফিকেশনের জন্য কন্টেন্ট।
live_activity.attributes-type	String	প্রয়োজনীয়	লাইভ অ্যাক্টিভিটিতে ব্যবহৃত অ্যাট্রিবিউটের প্রকার।
live_activity.attributes	Object	প্রয়োজনীয়	লাইভ অ্যাক্টিভিটির জন্য অ্যাট্রিবিউট।
live_activity_id	String	প্রয়োজনীয়	লাইভ অ্যাক্টিভিটির জন্য একটি ইউনিক আইডেন্টিফায়ার। updateLiveActivity কল করার সময় এই অ্যাক্টিভিটিটিকে টার্গেট করতে ব্যবহৃত হয়। প্রতিটি অ্যাক্টিভিটি সেশনের জন্য ইউনিক হতে হবে।
filter	String	ঐচ্ছিক	একটি Pushwoosh ফিল্টারের (সেগমেন্ট) নাম। দেখুন সেগমেন্ট / ফিল্টার নাম। এই ফিল্টারের সাথে মিলে যাওয়া সমস্ত ডিভাইসে লাইভ অ্যাক্টিভিটি শুরু হবে।
devices	Array of Strings	ঐচ্ছিক	ডিভাইস টোকেন এর একটি তালিকা। শুধুমাত্র নির্দিষ্ট ডিভাইসগুলিতে লাইভ অ্যাক্টিভিটি শুরু হবে।
send_date	String	ঐচ্ছিক	একটি নির্দিষ্ট তারিখ এবং সময়ের জন্য লাইভ অ্যাক্টিভিটি শুরু করা পুশটি শিডিউল করে — filter বা devices টার্গেটিংয়ের সাথে কাজ করে। YYYY-MM-DD HH:mm ফরম্যাট ব্যবহার করুন, অথবা অবিলম্বে শুরু করতে now ব্যবহার করুন (প্যারামিটারটি বাদ দেওয়া হলে এটিই ডিফল্ট)। এটি অতীতের ১ দিনের বেশি বা ভবিষ্যতের ৩০ দিনের বেশি হতে পারবে না, অন্যথায় রিকোয়েস্টটি একটি ভ্যালিডেশন ত্রুটির সাথে প্রত্যাখ্যান করা হবে।
timezone	String	ঐচ্ছিক	send_date ব্যাখ্যা করতে ব্যবহৃত টাইমজোন। যদি বাদ দেওয়া হয়, send_date UTC-তে ব্যাখ্যা করা হয়।

সতর্কতা

startLiveActivity-এর মাধ্যমে একটি লাইভ অ্যাক্টিভিটির রিমোট স্টার্টের জন্য ডিভাইসে iOS 17.2+ প্রয়োজন — আগের ভার্সনগুলি pushToStartTokenUpdates API সাপোর্ট করে না, যার উপর এই এন্ডপয়েন্টটি নির্ভর করে। দেখুন একটি রিমোট পুশ নোটিফিকেশন দিয়ে লাইভ অ্যাক্টিভিটি শুরু করুন।

একটি filter (সেগমেন্ট) টার্গেট করার সময়, নির্ধারিত পাঠানোর সময় হল যখন Pushwoosh পুশ পাঠানো শুরু করে, এটি একটি নিশ্চিত ডেলিভারি মুহূর্ত নয় — বড় দর্শকদের জন্য, স্বতন্ত্র ডিভাইসগুলিতে ডেলিভারি send_date থেকে কয়েক মিনিট পিছিয়ে থাকতে পারে, কারণ লাইভ অ্যাক্টিভিটি পুশের পাঠানোর হার send_rate দিয়ে কাস্টমাইজ করা যায় না।

রিকোয়েস্টের উদাহরণ

ফিল্টার সহ

{
  "request": {
    "application": "XXXXX-XXXXX",
    "auth": "SECRET_API_TOKEN",
    "notifications": [
      {
        "content": "Your order is being prepared",
        "title": "Food Delivery",
        "live_activity": {
          "event": "start",
          "title": "Order status",
          "content-state": {
            "status": "Third",
            "estimatedTime": "37 min",
            "emoji": "👨‍🍳"
          },
          "attributes-type": "FoodDeliveryAttributes",
          "attributes": {}
        },
        "live_activity_id": "FIRST_LIVE_ACTIVITY",
        "filter": "FILTER_NAME_1"
      }
    ]
  }
}

ডিভাইস সহ

{
  "request": {
    "application": "XXXXX-XXXXX",
    "auth": "SECRET_API_TOKEN",
    "notifications": [
      {
        "content": "Your order is being prepared",
        "title": "Food Delivery",
        "live_activity": {
          "event": "start",
          "title": "Order status",
          "content-state": {
            "status": "Third",
            "estimatedTime": "37 min",
            "emoji": "👨‍🍳"
          },
          "attributes-type": "FoodDeliveryAttributes",
          "attributes": {}
        },
        "live_activity_id": "SECOND_LIVE_ACTIVITY",
        "devices": ["first_third", "second_device"]
      }
    ]
  }
}

শিডিউলড স্টার্ট

{
  "request": {
    "application": "XXXXX-XXXXX",
    "auth": "SECRET_API_TOKEN",
    "notifications": [
      {
        "content": "Your order is being prepared",
        "title": "Food Delivery",
        "live_activity": {
          "event": "start",
          "title": "Order status",
          "content-state": {
            "status": "Third",
            "estimatedTime": "37 min",
            "emoji": "👨‍🍳"
          },
          "attributes-type": "FoodDeliveryAttributes",
          "attributes": {}
        },
        "live_activity_id": "THIRD_LIVE_ACTIVITY",
        "filter": "FILTER_NAME_1",
        "send_date": "2026-06-16 16:00"
      }
    ]
  }
}

রেসপন্সের উদাহরণ

{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "Messages": [
      "XXXXX-XXXXXXXX-XXXXXXXX"
    ]
  }
}

দ্রষ্টব্য:

Pushwoosh iOS SDK ব্যবহার করে লাইভ অ্যাক্টিভিটিজ নিয়ে কাজ করার বিষয়ে আরও জানতে এই নিবন্ধটি পড়ুন।

updateLiveActivity

POST https://api.pushwoosh.com/json/1.3/updateLiveActivity

iOS লাইভ অ্যাক্টিভিটিজ আপডেট এবং শেষ করার অনুমতি দেয়।

রিকোয়েস্ট বডি

প্যারামিটার	টাইপ	প্রয়োজনীয়/ঐচ্ছিক	বর্ণনা
auth	String	প্রয়োজনীয়	Pushwoosh কন্ট্রোল প্যানেল থেকে API অ্যাক্সেস টোকেন।
application	String	প্রয়োজনীয়	Pushwoosh অ্যাপ্লিকেশন কোড
notifications	Array	প্রয়োজনীয়	মেসেজ প্যারামিটারের JSON অ্যারে। নিচের নোটিফিকেশন টেবিলে বিস্তারিত দেখুন।

নোটিফিকেশন

notifications অ্যারেতে ব্যবহৃত প্যারামিটার:

প্যারামিটার	টাইপ	প্রয়োজনীয়/ঐচ্ছিক	বর্ণনা
live_activity	Object	প্রয়োজনীয়	iOS-এ লাইভ অ্যাক্টিভিটি আপডেট করার জন্য লাইভ অ্যাক্টিভিটি ডেটা।
live_activity.event	String	প্রয়োজনীয়	ইভেন্টের প্রকার নির্দিষ্ট করে। লাইভ অ্যাক্টিভিটি আপডেট করতে "update" ব্যবহার করুন অথবা এটি বন্ধ করতে "end" ব্যবহার করুন।
live_activity.content-state	Object	প্রয়োজনীয়	কী-ভ্যালু পেয়ার সহ অবজেক্ট যা লাইভ অ্যাক্টিভিটিতে তার কন্টেন্ট আপডেট করার জন্য ডেটা পাস করতে ব্যবহৃত হয়।
live_activity.dismissal-date	Integer	ঐচ্ছিক	সময় (সেকেন্ডে) যখন লাইভ অ্যাক্টিভিটি শেষ হওয়া উচিত।
live_activity_id	String	প্রয়োজনীয়	আপডেট করার জন্য লাইভ অ্যাক্টিভিটির ইউনিক আইডেন্টিফায়ার। startLiveActivity-তে ব্যবহৃত live_activity_id-এর সাথে অবশ্যই মিলতে হবে। আপডেটটি সেই সমস্ত ডিভাইসে বিতরণ করা হবে যেখানে এই অ্যাক্টিভিটি শুরু হয়েছিল।
live_activity.relevance-score	Integer	ঐচ্ছিক	iOS সিস্টেমকে জানায় কোন লাইভ অ্যাক্টিভিটির অগ্রাধিকার অন্যদের চেয়ে বেশি। ১ থেকে অসীম পর্যন্ত মান গ্রহণ করে (১০০ পর্যন্ত মান সুপারিশ করা হয়)।
live_activity.stale-date	Integer	ঐচ্ছিক	সময় (সেকেন্ডে) যা সেই তারিখটিকে প্রতিনিধিত্ব করে যখন একটি লাইভ অ্যাক্টিভিটি পুরনো বা অচল হয়ে যায়।

রিকোয়েস্টের উদাহরণ

{
  "request": {
    "application": "XXXXX-XXXXX",
    "auth": "SECRET_API_TOKEN",
    "notifications": [
      {
        "live_activity": {
          "event": "update",
          "title": "Live Activity Update",
          "content-state": {
            "status": "second 66",
            "estimatedTime": "66 min",
            "emoji": "👨‍"
          },
          "relevance-score": 60
        },
        "live_activity_id": "FIRST_LIVE_ACTIVITY"
      }
    ]
  }
}

রেসপন্সের উদাহরণ

{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "Messages": [
      "XXXXX-XXXXXXXX-XXXXXXXX"
    ]
  }
}

Pushwoosh iOS SDK ব্যবহার করে লাইভ অ্যাক্টিভিটিজ নিয়ে কাজ করার বিষয়ে আরও জানতে এই নিবন্ধটি পড়ুন।

প্রতি ডিভাইসে একাধিক অ্যাক্টিভিটি

আপনি একই ডিভাইসে একাধিক লাইভ অ্যাক্টিভিটি শুরু করতে পারেন, ভিন্ন ভিন্ন live_activity_id মান দিয়ে startLiveActivity একাধিকবার কল করে।

উদাহরণস্বরূপ, যদি আপনি দুটি অ্যাক্টিভিটি শুরু করেন: FIRST_LIVE_ACTIVITY filter: FILTER_NAME_1 সহ এবং SECOND_LIVE_ACTIVITY filter: FILTER_NAME_2 সহ, তাহলে যে ডিভাইসটি উভয় ফিল্টারের সাথে মেলে, সেখানে উভয় অ্যাক্টিভিটি একই সাথে চলবে।

তাদের মধ্যে একটি আপডেট করতে, তার live_activity_id updateLiveActivity-তে পাস করুন। আপডেটটি সেই সমস্ত ডিভাইসে পৌঁছে দেওয়া হয় যেখানে সেই অ্যাক্টিভিটি তৈরি হয়েছিল। অন্য অ্যাক্টিভিটি প্রভাবিত হয় না।

relevance-score প্যারামিটারটি ডিসপ্লে অগ্রাধিকার নিয়ন্ত্রণ করে যখন একই ডিভাইসে একাধিক লাইভ অ্যাক্টিভিটি সক্রিয় থাকে। যদি স্ক্রিনের জায়গা সীমিত থাকে বা অ্যাক্টিভিটিগুলি গ্রুপ করা হয়, তবে উচ্চতর মান সহ অ্যাক্টিভিটিটি উচ্চতর অগ্রাধিকারের সাথে দেখানো হয়।