కంటెంట్‌కు వెళ్లండి

HTTP మాట్లాడే ప్రతి దానికీ iOS లైవ్ యాక్టివిటీ API

PushWard అనేది Apple లైవ్ యాక్టివిటీల కోసం ఒక API: ఒక్క HTTP రిక్వెస్ట్ పంపండి; అది iPhone లాక్ స్క్రీన్ మరియు Dynamic Island పై లైవ్‌గా కనిపించి, రియల్-టైమ్‌లో అప్‌డేట్ అవుతూ, పని పూర్తయ్యాక తనంతట తానే తొలగిపోతుంది. ActivityKit కోడ్ లేదు, Xcode లేదు, మీ వైపు App Store సమీక్ష కూడా లేదు.

లైవ్ యాక్టివిటీ అంటే ఏమిటి?

లైవ్ యాక్టివిటీ అనేది లాక్ స్క్రీన్‌పై, Dynamic Island లో మరియు స్టాండ్‌బైలో లైవ్‌గా, ఒక్క చూపులో అర్థమయ్యే సమాచారాన్ని చూపించే iOS ఫీచర్ — స్వీకర్త ఎప్పుడూ ఏ యాప్‌నూ తెరవాల్సిన అవసరం లేదు. ఒకసారి కనిపించి జాబితాలో కలిసిపోయే పుష్ నోటిఫికేషన్‌లా కాకుండా, లైవ్ యాక్టివిటీ స్థిరంగా ఉండి రియల్-టైమ్‌లో అప్‌డేట్ అవుతుంది: దశలను దాటుతున్న బిల్డ్, వెనక్కి లెక్కించే టైమర్, దగ్గరపడుతున్న డెలివరీ. 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 రిఫరెన్స్ పోల్చండి