जावास्क्रिप्ट एसडीके के साथ लाइव संदेश और उपस्थिति भेजें
aura.realtime का दैनिक प्रवाह, प्रत्येक कॉल के व्यवहार के साथ जैसा कि एक रनिंग स्टैक के विरुद्ध देखा गया है।
चैनल और उनकी स्थिति#
चैनल एक नामित कमरा है. जो ग्राहक समान नाम खोलते हैं उन्हें एक-दूसरे के संदेश प्राप्त होते हैं। जब आप सदस्यता लेते हैं तो क्लाइंट अपने आप कनेक्ट हो जाता है।
const room = aura.realtime.channel('room-1')
room.subscribe((status) => {
// 'सब्सक्राइब्ड' | 'चैनल_त्रुटि' | 'TIMED_OUT' | 'बंद किया हुआ'
if (status === 'SUBSCRIBED') console.log('ready')
})
SUBSCRIBED के बाद ही भेजें। उससे पहले, या इनकार के बाद, send() भेजने के बजाय not_connected या requires_subscription जैसी स्थिति लौटाता है। चैनल आपके प्रोजेक्ट के दायरे में हैं: दो प्रोजेक्ट एक-दूसरे को देखे बिना एक ही नाम का उपयोग कर सकते हैं।
प्रसारण संदेश#
// प्राप्त करें
room.on('broadcast', { event: 'ping' }, (message) => {
console.log(message.payload) // {घटना: 'पिंग', एन: 1, पाठ: 'हैलो' }
})
// एक बार सदस्यता लेने के बाद भेजें
const status = await room.send({ type: 'broadcast', event: 'ping', payload: { n: 1, text: 'hello' } })
// → 'ठीक है'
वास्तव में, एक दूसरे साइन-इन क्लाइंट को दो सेकंड के अंदर संदेश प्राप्त हुआ।
आपको प्राप्त संदेश में इवेंट का नाम payload: { "event": "ping", "n": 1, … } जोड़ा गया है। एक पेलोड जिसकी अपनी event कुंजी होती है, उसे अस्वीकार कर दिया जाता है (channel.send 'invalid_payload' लौटाता है, httpBroadcast realtime_payload_event_reserved लौटाता है): कुंजी का नाम बदलें, उदाहरण के लिए kind।
- आपको डिफ़ॉल्ट रूप से अपने संदेश प्राप्त नहीं होते हैं। उन्हें प्राप्त करने के लिए
{ config: { broadcast: { self: true } } }के साथ चैनल खोलें। - एक संदेश में
id,topic,timestamp,eventऔरpayloadहोते हैं।
उपस्थिति#
उपस्थिति से पता चलता है कि आपके द्वारा चुने गए राज्य के साथ, चैनल से कौन जुड़ा है।
const lobby = aura.realtime.channel('lobby', { config: { presence: { key: user.id } } })
lobby.on('presence', { event: 'sync' }, () => {
console.log(lobby.presenceState())
})
lobby.subscribe(async (status) => {
if (status === 'SUBSCRIBED') await lobby.track({ name: 'Bob' })
})
presenceState() को उपयोगकर्ता आईडी द्वारा कुंजीबद्ध किया जाता है। प्रत्येक प्रविष्टि उपयोगकर्ता के कनेक्शन सूचीबद्ध करती है:
{
"d6ba3994-…": [
{ "client_id": "936cb015-…", "user_id": "d6ba3994-…", "metadata": { "name": "Bob" },
"joined_at": "2026-10-12T19:32:19.093Z", "last_seen": "2026-10-12T19:32:19.096Z" }
]
}
untrack() आपको सूची से हटा देता है, और चैनल छोड़ना या पेज बंद करना आपके लिए काम करता है।
डेटाबेस परिवर्तन#
postgres_changes अपने स्वयं के डेटाबेस के साथ परियोजनाओं पर काम करता है। पहले प्रत्येक तालिका को सक्षम करें: PUT /v1/db/schema/tables/{table}/realtime (या aura db table realtime <table> on) मुख्य भाग {"enabled": true} और एक service_role कुंजी के साथ। सुनना तब शुरू होता है जब पहला ग्राहक सदस्यता लेता है और अंतिम ग्राहक के जाने के कुछ मिनट बाद बंद हो जाता है। डिलीवरी कम से कम एक बार होती है: सर्वर पुनरारंभ होने के बाद परिवर्तन दो बार आ सकता है, इसलिए अपने हैंडलर को निष्क्रिय बनाएं, उदाहरण के लिए पंक्ति की प्राथमिक कुंजी पर कुंजी लगाकर। एक व्यस्त क्लस्टर क्षमता त्रुटि के साथ नए श्रोता को मना कर सकता है; शीघ्र ही पुनः प्रयास करें. कोई भी चैनल नाम काम करता है: प्रत्येक फ़िल्टर का table सुनने के लिए तालिका का चयन करता है, और एक चैनल कई तालिकाओं को सुन सकता है। ऐसे चैनल पर जिसका नाम db:<schema>.<table> नहीं है, प्रत्येक फ़िल्टर को table की आवश्यकता होती है। पहला ग्राहक सदस्यता लेने से ठीक पहले किए गए परिवर्तनों के 5 सेकंड तक प्राप्त कर सकता है। परिवर्तनों को पुनर्प्राप्ति के लिए एक घंटे तक रखा जाता है, फिर हटा दिया जाता है। जब क्लस्टर भर जाता है, तो सदस्यता capacité d'écoute postgres_changes atteinte pour la base de ce projet, réessayez के साथ विफल हो जाती है। यदि सुनना एक मिनट से अधिक समय तक बंद रहता है, तो चैनल CHANNEL_ERROR पर चला जाता है, फिर सुनना बहाल होने पर वापस SUBSCRIBED पर आ जाता है; आपको दोबारा सदस्यता लेने की आवश्यकता नहीं है. यदि कोई आउटेज एक घंटे के अवधारण से अधिक रहता है, तो चैनल को changements postgres_changes perdus pendant l'interruption, resynchronisez के साथ CHANNEL_ERROR भी प्राप्त होता है: डेटाबेस से डेटा पुनः लोड करें। हर बार डिलीवर होने पर परिवर्तन वही id रखता है, इसलिए आप उस id को छोड़ भी सकते हैं जिसे आपने पहले ही संभाल लिया है। डिलीट की पंक्ति अब मौजूद नहीं है, इसलिए उस पर पंक्ति स्तर की सुरक्षा का मूल्यांकन नहीं किया जा सकता है। पंक्ति स्तर की सुरक्षा वाली तालिका पर, DELETE केवल उन ग्राहकों को वितरित किया जाता है जिनकी भूमिका तालिका पर SELECT नीति है (या RLS को बायपास करता है, जैसे service_role): एक विज़िटर (anon) बिना पढ़ने की नीति के इसे प्राप्त नहीं करता है। पंक्ति स्तरीय सुरक्षा के बिना एक टेबल पर प्रत्येक ग्राहक को यह प्राप्त होता है। DELETE के payload.old में केवल प्राथमिक कुंजी कॉलम होते हैं (यदि तालिका में कोई प्राथमिक कुंजी नहीं है तो कुछ भी नहीं), और किसी अन्य कॉलम पर फ़िल्टर कभी भी डिलीट से मेल नहीं खाता है। UPDATE के लिए, payload.old केवल पिछली पंक्ति के प्राथमिक कुंजी कॉलम रखता है (यदि कुंजी बदल गई है तो उनके पिछले मान), इसके अन्य मान कभी नहीं: पंक्ति स्तर की सुरक्षा केवल नई पंक्ति पर जांची जाती है। UPDATE का फ़िल्टर नई पंक्ति पर लागू होता है। संवेदनशील जानकारी को प्राथमिक कुंजियों से दूर रखें.
const changes = aura.realtime
.channel('todos')
.on('postgres_changes', { event: '*', schema: 'public', table: 'todos' }, (payload) => {
console.log(payload.eventType, payload.new)
})
.subscribe((status) => {
if (status === 'CHANNEL_ERROR') console.warn('database changes are not available for this project')
})
साफ - सफाई#
room.unsubscribe() // एक चैनल छोड़ो
aura.realtime.removeChannel(room) // छोड़ो और इसे भूल जाओ
aura.realtime.removeAllChannels() // हर चैनल छोड़ो
aura.realtime.disconnect() // कनेक्शन बंद करें
aura.realtime.onStateChange(callback) और onError(callback) के साथ कनेक्शन देखें। गिरावट के बाद, जब तक आप setAutoReconnect(false) पर कॉल नहीं करते, क्लाइंट अपने आप पुनः कनेक्ट हो जाता है।