Web Client DAT

پرش به ناوبری
پرش به جستجو

خلاصه

Web Client DAT به شما اجازه می‌دهد از داخل TouchDesigner به وب‌سرورها درخواست HTTP ارسال کنید.
این اپراتور از متدهای HTTP زیر پشتیبانی می‌کند:

GET، POST، PUT، DELETE، HEAD، OPTIONS و PATCH

Web Client DAT از انواع مختلف احراز هویت پشتیبانی می‌کند، از جمله:
Basic، OAuth1 و OAuth2

همچنین Web Client DAT امکان استریم داده از وب‌سرورها را فراهم می‌کند.

Web Client DAT درخواست‌های HTTP را به وب‌سرورها ارسال کرده و پاسخ دریافتی را در DAT خروجی می‌دهد. در صورت فعال بودن استریم، داده‌ها به‌صورت پیوسته از وب‌سرور دریافت می‌شوند.

وقتی استریم فعال باشد، باید گزینه Clamp Output as Rows نیز فعال شود.
این گزینه خروجی DAT را به‌جای متن خام، به یک جدول FIFO (اولین ورودی، اولین خروجی) تبدیل می‌کند.
در این حالت فقط آخرین N خط نمایش داده می‌شود که N مقدار پارامتر Maximum Lines است.
این کار از بیش از حد بزرگ شدن متن DAT جلوگیری می‌کند و در نتیجه زمان‌های Cook را کاهش می‌دهد.

Web Client DAT از ارسال درخواست با متدهای GET، POST، PUT، DELETE، HEAD، OPTIONS و PATCH پشتیبانی می‌کند.
همچنین از ۴ روش احراز هویت پشتیبانی می‌شود:

  • Basic

  • Digest

  • OAuth1

  • OAuth2

ورودی‌ها

ورودی اول شامل هدرهای اضافی است که باید همراه درخواست ارسال شوند.
این ورودی باید یک جدول با دو ستون (name / value) باشد. مثال:

Content-Type application/json
Connection Close

ورودی دوم داده‌ها یا پارامترهایی است که همراه درخواست ارسال می‌شوند.
این ورودی می‌تواند:

  • یک جدول دو ستونه از جفت‌های name/value باشد

  • یا متن ساده باشد که در این صورت همان‌طور که هست ارسال می‌شود

اگر متد درخواست دارای بدنه (Request Body) نباشد (مثلاً GET یا OPTIONS)، در صورتی که ورودی دوم یک جدول باشد، داده‌ها به URL به‌عنوان Query Parameters اضافه می‌شوند؛ در غیر این صورت، به‌عنوان داده‌ی درخواست ارسال می‌شوند.

مثال داده:

name joe
month May

Web Client DAT جایگزین (نسل بعدی) Web DAT است.

همچنین ببینید:
Web Server DAT، SocketIO DAT، XML DAT، TCP/IP DAT، WebSocket DAT، Web DAT

محتویات

  1. خلاصه

  2. پارامترها – صفحه Web Client

  3. پارامترها – صفحه Authentication

  4. پارامترها – صفحه Output

  5. پارامترها – صفحه Common

  6. ورودی‌های اپراتور

  7. کانال‌های Info CHOP
     7.1 کانال‌های اطلاعات اختصاصی Web Client DAT
     7.2 کانال‌های اطلاعات DAT مشترک
     7.3 کانال‌های اطلاعات اپراتور مشترک

پارامترها – صفحه Web Client

  • Active (active)
    اپراتور را روشن یا خاموش می‌کند.

  • Request Method (reqmethod) ⊞
    انتخاب متد درخواست HTTP.

  • URL (url)
    آدرس URL سروری که درخواست HTTP به آن ارسال می‌شود.
    معمولاً اگر سرور امن باشد، URL باید با https:// شروع شود.

  • Upload File (uploadfile)
    محتوای فایل آپلودشده به سرور ارسال می‌شود (در صورت نیاز به‌صورت chunked).

  • Request (request)
    ارسال درخواست.

  • Stop (stop)
    استریم داده از سرور را متوقف می‌کند.

  • Stream (stream)
    استریم را فعال می‌کند.
    فقط زمانی لازم است که سرور از استریم پشتیبانی کند.

  • Verify Certificate (SSL) (verifycert)
    بررسی و اعتبارسنجی گواهی TLS (امنیت لایه انتقال) را فعال می‌کند.

  • Timeout (timeout)
    زمان انتظار (بر حسب میلی‌ثانیه) برای دریافت پاسخ از وب‌سرور.

  • Include Header in Output (includeheader)
    هدرهای پاسخ HTTP را نیز در خروجی DAT نمایش می‌دهد.

پارامترها – صفحه Authentication

  • Authentication Type (authtype) ⊞
    نوع احراز هویت.

  • Username (username)
    نام کاربری برای احراز هویت Basic یا Digest.

  • Password (pw)
    رمز عبور برای احراز هویت Basic یا Digest.

  • App Key (appkey)
    کلید اپلیکیشن OAuth1 که از وب‌سرور دریافت شده است.

  • App Secret (appsecret)
    رمز اپلیکیشن OAuth1 که از وب‌سرور دریافت شده است.

  • User OAuth Token (oauthtoken)
    توکن کاربر OAuth1 دریافت‌شده از وب‌سرور.

  • User OAuth Secret (oauthsecret)
    رمز توکن کاربر OAuth1 دریافت‌شده از وب‌سرور.

  • Client ID (clientid)
    شناسه کلاینت OAuth2 دریافت‌شده از وب‌سرور.

  • Token (token)
    توکن OAuth2 دریافت‌شده از وب‌سرور.

پارامترها – صفحه Output

  • Clear Output (clear)
    خروجی DAT را پاک می‌کند.

  • Clamp Output as Rows (clamp)
    وقتی فعال باشد، خروجی DAT به‌جای متن، به‌صورت جدول نمایش داده می‌شود.
    همچنین تعداد ردیف‌ها به مقدار پارامتر Maximum Lines محدود می‌شود.
    این گزینه هنگام استریم باید فعال باشد تا خروجی بیش از حد بزرگ نشود.

  • Maximum Lines (maxlines)
    حداکثر تعداد ردیف‌ها هنگام فعال بودن Clamp.

  • Callbacks DAT (callbacks)
    DAT شامل Callbackها.

پارامترها – صفحه Common

  • Language (language) ⊞
    تعیین می‌کند DAT از کدام زبان اسکریپت استفاده کند.

  • Edit/View Extension (extension) ⊞
    تعیین پسوند فایلی که DAT به ویرایشگرهای خارجی معرفی می‌کند.

  • Custom Extension (customext)
    تعیین پسوند سفارشی.

  • Word Wrap (wordwrap) ⊞
    فعال‌سازی شکستن خط (Word Wrap) برای نمایش نود.

ورودی‌های اپراتور

  • Input 0: –

  • Input 1: –

کانال‌های Info CHOP

اطلاعات اضافی Web Client DAT از طریق یک Info CHOP قابل دسترسی است.

کانال‌های اطلاعات اختصاصی Web Client DAT

  • download_progress – میزان پیشرفت دانلود

  • downloaded_size – حجم دانلودشده

  • total_size – حجم کل

  • connected – وضعیت اتصال

  • connection_error – خطای اتصال

  • communicating – وضعیت تبادل داده

کانال‌های اطلاعات DAT مشترک

  • num_rows – تعداد ردیف‌های DAT

  • num_cols – تعداد ستون‌های DAT

کانال‌های اطلاعات اپراتور مشترک

  • total_cooks – تعداد دفعات Cook شدن اپراتور

  • cook_time – مدت زمان آخرین Cook (میلی‌ثانیه)

  • cook_frame – شماره فریم Cook نسبت به تایم‌لاین کامپوننت

  • cook_abs_frame – شماره فریم Cook نسبت به زمان مطلق

  • cook_start_time – زمان شروع Cook (میلی‌ثانیه)

  • cook_end_time – زمان پایان Cook (میلی‌ثانیه)

  • cooked_this_frame – اگر اپراتور در این فریم Cook شده باشد مقدار 1

  • warnings – تعداد هشدارها

  • errors – تعداد خطاها