هذه الصفحة مترجمة من الإنجليزية. إذا اختلفت النسختان، فالصفحة الإنجليزية هي الصحيحة. اقرأ الصفحة الإنجليزية
أربع عمليات تبث نتائجها على شكل أحداث مرسلة من الخادم: توليد المفردات، وإرسال رسالة إلى المعلّم، وإنشاء خطة درس، ومتابعة خطة قائمة. تحوّل كل مكتبة تدفق الأحداث إلى نوع المُكرِّر الخاص باللغة، وتسلّمك كل حدث بعد فكّ ترميزه مسبقًا إلى قيمة ذات نوع محدد.
كيف ينتهي التدفق
عند اكتمال العمل. يتوقف التكرار من تلقاء نفسه عند الحدث الأخير للتدفق. في خطة الدرس، يحمل ذلك الحدث الأخير النتيجة، فتتلقاها قبل انتهاء الحلقة.
عندما يبلّغ الـ API عن خطأ. الخطأ الذي يصل داخل التدفق يُرفع كخطأ API، من النوع نفسه الذي يصل قبله.
عند فشل الاتصال. التدفق الذي ينتهي قبل حدثه الأخير، أو لا يرسل شيئًا على الإطلاق لمدة 120 ثانية، يُرفع كخطأ نقل.
عندما تتوقف أنت. ألغِ الاستدعاء بالطريقة المعتادة في لغتك، أو توقّف عن القراءة، فيُغلق الاتصال فورًا.
تُتخطّى تعليقات إبقاء الاتصال حيًّا وأنواع الأحداث التي لا تعرفها المكتبة بعد، لذا لا يُعطّل API أحدث مكتبةً أقدم أبدًا.
لا إعادة تشغيل أبدًا
التدفق الذي سلّم ولو حدثًا واحدًا لا تعيد المكتبة محاولته أبدًا، لأن تكراره قد يستهلك رصيدك مرتين. إذا انقطع تدفق خطة درس بعد أن بدأ، فتابع الخطة نفسها باستخدام streamLessonPlan وplan_id من حدثها الأول.