جديدPublication of @aurabase/aurabase-js v0.7.5 NPM Packages & Rust Crate v0.1.2انظر سجل التغيير →

الوقت الحقيقي

البيانات الحية، مباشرة من قاعدة البيانات الخاصة بك.

يحمل اتصال WebSocket واحد تغييرات قاعدة البيانات ورسائل البث والتواجد. تتبع القنوات الخاصة نفس الأمان على مستوى الصف الذي تتبعه جداولك.

3
أنواع القنوات
25 s
الفاصل الزمني لنبضات القلب
realtime.tsTS
import { createClient } from '@aurabase/aurabase-js'
const aura = createClient(
'https://my-project.aurabase.cloud',
'aura_anon_xxx',
)
aura
.channel('room')
.on(
'postgres_changes',
{
event: 'INSERT',
schema: 'public',
table: 'messages',
filter: 'room_id=eq.42',
},
(payload) => console.log(payload),
)
.subscribe()

ما هو مدرج

كل ما يتحرك يعيش. على اتصال واحد.

قاعدة البيانات

تغييرات قاعدة البيانات

اشترك في الإدخالات والتحديثات والحذف على الجدول فور حدوثها.

المرشحات

مرشحات العمود

احصل على الصفوف التي تهمك فقط، مثل Room_id=eq.42. يقوم الخادم بتطبيق عامل التصفية قبل أن يرسل الحدث.

المراسلة

بث

أرسل رسائل بين العملاء على قناة ما، مع إقرار الخادم الاختياري.

وجود

المتواجدون الآن

تتبع المستخدمين على القناة وقم بالتفاعل عند انضمامهم أو مغادرتهم أو تحديث حالتهم.

الأمن

القنوات الخاصة

تحدد سياسات الأمان على مستوى الصف من يمكنه الانضمام إلى قناة خاصة، ويتم التحقق منها مرة أخرى عند تحديث الرمز المميز.

الأمن

مشاريع خاصة فقط

اشتراط أن تكون كل قناة في المشروع خاصة، مهما كان ما يطلبه العميل.

جانب الخادم

البث عبر HTTP

النشر من خادم أو وظيفة حافة بطلب واحد.

الموثوقية

إعادة الاتصال التلقائي

يكتشف نبض القلب الاتصالات الميتة، ويعيد العميل الاتصال مع التراجع والارتعاش، ثم يعيد الاشتراك في قنواته.

إمكانية الملاحظة

مسح حالات الاتصال والقناة

اتبع حالة الاتصال، واحصل على أخطاء النقل مع المرحلة التي فشلت، واعرف سبب رفض القناة.

كيف يعمل

من التغيير إلى الشاشة.

  1. 1

    الاتصال

    يفتح SDK WebSocket واحدًا باستخدام الرمز المميز للمستخدم.

  2. 2

    اشترك

    انضم إلى قناة؛ يتحقق الخادم من الوصول ويؤكد.

  3. 3

    تلقي

    تصل تغييرات قاعدة البيانات وعمليات البث والتواجد إلى تلك القناة.

  4. 4

    استرداد

    إذا انقطع الارتباط، يقوم SDK بإعادة الاتصال وإعادة الاشتراك.

نقاط النهاية

طريقان. كل شيء آخر هو قناة.

أرسل مفتاح API الخاص بمشروعك أو الرمز المميز للمستخدم مع كل طلب.

الطريقةنقطة النهايةالوصف
GET/v1/realtime/wsافتح اتصال WebSocket. يتم مضاعفة القنوات فوقه.
POST/v1/realtime/broadcastأرسل بثًا عبر HTTP، بدون WebSocket.

أسئلة

من الجيد أن نعرف.

كيف يمكنني تلقي تغييرات قاعدة البيانات؟+
اشترك في postgres_changes على قناة تحتوي على المخطط والجدول والحدث الذي تريده. قم بإضافة عامل تصفية لتلقي الصفوف المطابقة فقط.
من يستطيع رؤية قناة خاصة؟+
تحدده سياسات الأمان على مستوى الصف من الرمز المميز للمستخدم عند الاشتراك. الرمز المميز الذي ترفضه السياسة يؤدي إلى خطأ في القناة.
هل يمكنني إرسال رسائل من الخادم الخاص بي؟+
نعم. httpBroadcast() يرسل بثًا عبر HTTP. قم بإضافة بادئة للقناة بمعرف المشروع الخاص بك عند الاتصال بها بدون جلسة مستخدم.
ماذا يحدث عندما ينقطع الاتصال؟+
يقوم SDK بإعادة الاتصال تلقائيًا وإعادة الاشتراك في قنواتك. لا يمكن ضمان تسليم الأحداث التي تم إرسالها أثناء انقطاع الاتصال، لذا أعد قراءة الحالة التي لا يمكنك تفويتها.
لماذا يجب علي الاشتراك قبل الإرسال؟+
يتم حساب قواعد الوصول للقناة عند الاشتراك. يتم رفض الإرسال إلى قناة لم تشترك فيها، وتقوم SDK بالإبلاغ عنه دون إرسال أي شيء.
ما الأحداث التي يراها مرشح الحذف؟+
الصف القديم. تعتمد الأعمدة التي تحملها على هوية النسخة المتماثلة للجدول: المفتاح الأساسي افتراضيًا، وجميع الأعمدة ذات هوية النسخة المتماثلة الكاملة.

هل أنت مستعد للبث المباشر؟

اجعل تطبيقك يتفاعل في الوقت الفعلي.

يتم تضمين الوقت الحقيقي في كل مشروع. لا حاجة لبطاقة الائتمان.