কনটেন্টে যান

HTTP বলতে পারে এমন সবকিছুর জন্য iOS লাইভ অ্যাক্টিভিটি API

PushWard হলো Apple-এর লাইভ অ্যাক্টিভিটির জন্য একটি API: একটিমাত্র HTTP রিকোয়েস্ট পাঠান, আর সেটি iPhone লক স্ক্রিন ও Dynamic Island-এ লাইভ দেখা যায়, রিয়েল-টাইমে আপডেট হয় এবং কাজ শেষ হলে নিজে থেকেই সরে যায়। ActivityKit কোড নেই, Xcode নেই, আপনার দিক থেকে App Store রিভিউও নেই।

লাইভ অ্যাক্টিভিটি কী?

লাইভ অ্যাক্টিভিটি হলো iOS-এর একটি ফিচার, যা লক স্ক্রিনে, Dynamic Island-এ এবং স্ট্যান্ডবাইতে লাইভ, এক নজরে বোঝা যায় এমন তথ্য দেখায় — প্রাপককে কখনো কোনো অ্যাপ খুলতে হয় না। একবার দেখা দিয়ে তালিকায় হারিয়ে যাওয়া পুশ নোটিফিকেশনের মতো নয়, লাইভ অ্যাক্টিভিটি পিন করা থাকে এবং রিয়েল-টাইমে আপডেট হয়: ধাপে ধাপে এগোনো একটি বিল্ড, কাউন্টডাউন করা একটি টাইমার, কাছে চলে আসা একটি ডেলিভারি। PushWard একটিমাত্র HTTP রিকোয়েস্টকে ঠিক এটিতেই বদলে দেয়।

Apple-এর লাইভ অ্যাক্টিভিটি, ActivityKit ছাড়াই

লাইভ অ্যাক্টিভিটি হলো iOS 16.1-এ আসা Apple-এর একটি iOS ফিচার: লক স্ক্রিন ও Dynamic Island-এ পিন করা, এক নজরে বোঝা যায় এমন রিয়েল-টাইম সারফেস। সাধারণত একটি বানাতে গেলে ActivityKit উইজেট এক্সটেনশনসহ নিজের iOS অ্যাপ শিপ করতে হয়, push-to-start টোকেন চাইতে হয় এবং নিজেই APNs-এর সঙ্গে কথা বলতে হয়। PushWard এই সবকিছুর জায়গায় আনে একটিমাত্র REST API: PushWard অ্যাপ আপনার লাইভ অ্যাক্টিভিটি রেন্ডার করে, আর একটিমাত্র HTTP রিকোয়েস্ট সেটিকে শুরু, আপডেট বা শেষ করে।

API যেভাবে কাজ করে

একটি অ্যাক্টিভিটি তৈরি করুন, শুরু করুন, আপডেট করুন এবং শেষ করুন — সবই আপনার ইন্টিগ্রেশন কী দিয়ে PushWard-এর REST API-এর মাধ্যমে। HTTP রিকোয়েস্ট পাঠাতে পারে এমন যেকোনো সার্ভিস ঠিক করতে পারে মানুষ এক নজরে কী দেখবে। APNs সার্টিফিকেট নেই, ক্লায়েন্ট কোড লেখারও কিছু নেই; ডেলিভারি PushWard সামলায় Apple Push Notification service-এর মাধ্যমে।

HTTP দিয়ে লাইভ অ্যাক্টিভিটি শুরু, আপডেট ও শেষ করুন 
# 1. Create an activity
curl -X POST https://api.pushward.app/activities \
  -H "Authorization: Bearer hlk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "slug": "deploy", "name": "Deploy to production" }'

# 2. Start the Live Activity on the Lock Screen
curl -X PATCH https://api.pushward.app/activities/deploy \
  -H "Authorization: Bearer hlk_YOUR_KEY" \
  -H "Content-Type: application/merge-patch+json" \
  -d '{ "state": "ongoing", "content": {
    "template": "generic", "progress": 0.2,
    "state": "Building...", "accent_color": "cyan"
  } }'

# 3. End it when the task is done
curl -X PATCH https://api.pushward.app/activities/deploy \
  -H "Authorization: Bearer hlk_YOUR_KEY" \
  -H "Content-Type: application/merge-patch+json" \
  -d '{ "state": "ended", "content": {
    "template": "generic", "progress": 1, "state": "Deployed"
  } }'

প্রতিটি ধরনের আপডেটের জন্য একটি টেমপ্লেট

ভিন্ন ভিন্ন কাজের জন্য তৈরি লাইভ অ্যাক্টিভিটি টেমপ্লেট থেকে বেছে নিন — একটি জেনেরিক প্রগ্রেস বার, কাউন্টডাউন, ধাপের সিকোয়েন্স, অ্যালার্ট, গেজ, টাইমলাইন স্পার্কলাইন, টাইলের বোর্ড, লাইভ ইভেন্ট লগ, কিংবা প্লেব্যাক বাটনসহ একটি মিডিয়া প্লেয়ার। প্রতিটির লেআউট লক স্ক্রিন ও Dynamic Island-এর জন্য টিউন করা।

টেমপ্লেটগুলো দেখুন →

আপনার স্ট্যাকের সঙ্গে কাজ করে

যে টুলগুলো আপনি ইতিমধ্যে চালাচ্ছেন, সেগুলো থেকেই সরাসরি লাইভ অ্যাক্টিভিটি পাঠান। রেডিমেড ব্রিজ আর হোস্টেড webhook relay কভার করে Grafana অ্যালার্ট, Home Assistant অটোমেশন, GitHub Actions, SABnzbd ডাউনলোড, Bambu Lab প্রিন্ট, ArgoCD সিঙ্ক এবং JSON পাঠাতে পারে এমন আর সবকিছু।

সব ইন্টিগ্রেশন দেখুন →

প্রায়শই জিজ্ঞাসিত প্রশ্ন

এটা কি Apple-এর অফিশিয়াল লাইভ অ্যাক্টিভিটি API?

না। Apple-এর অফিশিয়াল ফ্রেমওয়ার্ক হলো ActivityKit, যার জন্য নিজের iOS অ্যাপ বানিয়ে শিপ করতে হয়। PushWard একটি স্বাধীন iOS লাইভ অ্যাক্টিভিটি API: এটি আপনার আপডেটগুলো Apple Push Notification service-এর মাধ্যমে PushWard অ্যাপে পৌঁছে দেয়, যে অ্যাপ সেগুলো লক স্ক্রিন ও Dynamic Island-এ রেন্ডার করে।

আমি কি সার্ভার থেকে লাইভ অ্যাক্টিভিটি শুরু করতে পারি?

হ্যাঁ — এটাই তো আসল কথা। HTTP রিকোয়েস্ট পাঠাতে পারে এমন যেকোনো সার্ভার, স্ক্রিপ্ট বা অটোমেশন লাইভ অ্যাক্টিভিটি তৈরি, শুরু, আপডেট ও শেষ করতে পারে। Apple-এর push-to-start প্রক্রিয়া PushWard আপনার হয়ে সামলায়, তাই প্রাপক অ্যাপ না খুললেও অ্যাক্টিভিটি দেখা যায়।

প্রাপকদের কি কোনো অ্যাপ ইনস্টল করা লাগবে?

হ্যাঁ — বিনামূল্যের PushWard iOS অ্যাপ লাইভ অ্যাক্টিভিটি রেন্ডার করে। আপনাকে কিছুই বানাতে, সাইন করতে বা App Store-এ জমা দিতে হবে না; প্রাপকরা একবার PushWard ইনস্টল করেন, আর আপনার রিকোয়েস্টগুলো তাঁদের লক স্ক্রিন চালায়।

কোন কোন iPhone লাইভ অ্যাক্টিভিটি সাপোর্ট করে?

PushWard অ্যাপের জন্য iOS 26 বা তার পরের ভার্সন দরকার। Dynamic Island থাকা iPhone-এ লাইভ অ্যাক্টিভিটি আইল্যান্ডে বসে যায়; যেসব মডেলে তা নেই, সেখানে এটি লক স্ক্রিন ও স্ট্যান্ডবাইতে দেখা যায়।

iOS লাইভ অ্যাক্টিভিটি API ব্যবহার করে দেখুন

playground-এ একটি সিমুলেটেড iPhone-এ লাইভ অ্যাক্টিভিটি পৌঁছাতে দেখুন, অথবা গেটিং-স্টার্টেড গাইড পড়ে কয়েক মিনিটে curl দিয়ে আপনার প্রথমটি পাঠান।

Playground উইজেট ডকস পড়ুন API রেফারেন্স তুলনা