نام (NAME)

asciinema-play - بازپخش یک نشست ضبط‌شده ترمینال

خلاصه دستور (SYNOPSIS)

asciinema play [-s|--speed] [-l|--loop] [-i|--idle-time-limit] [-m|--pause-on-markers] [-r|--resize] [-q|--quiet] [-h|--help] <FILE>

توضیحات (DESCRIPTION)

بازپخش یک نشست ضبط‌شده ترمینال.

نمایش یک پرونده asciicast از پیش ضبط‌شده در ترمینال شما با کنترل‌های مختلف بازپخش (به بخش زیر مراجعه کنید). از پرونده‌های محلی و نشانی‌های اینترنتی دوردست (URL) پشتیبانی می‌کند.

برای متوقف کردن بازپخش کلید <ctrl+c> را فشار دهید. برای مکث/ادامه کلید <space> را فشار دهید. برای حرکت گام‌به‌گام به جلو (در حالت مکث) کلید '.' را فشار دهید. برای پرش به نشانه‌گذار بعدی (در حالت مکث) کلید ']' را فشار دهید.

گزینه‌ها (OPTIONS)

-s, --speed=SPEED

کنترل سرعت بازپخش به عنوان ضریبی از زمان‌بندی اصلی. مقادیر بزرگ‌تر از 1.0 بازپخش را سریع‌تر و مقادیر کمتر از 1.0 آن را کندتر می‌کنند. برای مثال، --speed 2.0 با دو برابر سرعت پخش می‌کند، در حالی که --speed 0.5 با نصف سرعت پخش می‌کند. مقدار پیش‌فرض 1.0 (سرعت اصلی) است. همچنین می‌توان آن را از طریق گزینه playback.speed در پرونده پیکربندی تنظیم کرد.

-l, --loop

فعال‌سازی پخش مداوم و چرخه‌ای (loop) فایل ضبط‌شده. هنگامی که ضبط به پایان می‌رسد، به‌طور خودکار از ابتدا مجدداً آغاز می‌شود. این فرآیند به‌طور نامحدود ادامه می‌یابد تا زمانی که بازپخش را با <ctrl+c> متوقف کنید.

-i, --idle-time-limit=SECS

محدود کردن حداکثر زمان بیکاری میان رویدادها در حین بازپخش به تعداد ثانیه‌های مشخص‌شده. مکث‌های طولانی در ضبط اصلی (مانند زمانی که کاربر از پای سیستم رفته است) به این مدت کاهش می‌یابد و تماشای بازپخش را روان‌تر و جذاب‌تر می‌کند. این گزینه بر هرگونه محدودیت زمان بیکاری تنظیم‌شده در خود فایل ضبط یا در پرونده پیکربندی شما (playback.idle_time_limit) اولویت دارد.

-m, --pause-on-markers

مکث خودکار بازپخش هنگام مواجهه با رویدادهای نشانه‌گذار (marker). نشانه‌گذارها رویدادهای ویژه‌ای هستند که می‌توان هنگام ضبط برای نشانه‌گذاری نقاط مهم یک نشست اضافه کرد. هنگامی که این گزینه فعال باشد، بازپخش در هر نشانه‌گذار متوقف می‌شود و به شما اجازه می‌دهد جریان نمایش را کنترل کنید. از کلید <space> برای ادامه، کلید '.' برای پیمایش گام‌به‌گام رویدادها، یا کلید ']' برای پرش به نشانه‌گذار بعدی استفاده کنید.

-r, --resize

تغییر اندازه خودکار پنجره ترمینال برای تطابق با ابعاد ضبط اصلی. این گزینه تلاش می‌کند اندازه ترمینال شما را تغییر دهد تا با اندازه‌ای که هنگام ضبط استفاده شده بود مطابقت داشته باشد، و تضمین کند که خروجی دقیقاً همان‌گونه که در ابتدا ضبط شده نمایش داده می‌شود. توجه داشته باشید که این ویژگی فقط توسط برخی ترمینال‌ها پشتیبانی می‌شود و ممکن است در همه محیط‌ها کار نکند.

-q, --quiet

فرونشاندن پیام‌های تشخیصی و نشانگرهای پیشرفت. فقط پیام‌های خطا نمایش داده خواهند شد.

-h, --help

چاپ راهنما (مشاهده خلاصه با '-h')

<FILE>

مسیر یک پرونده asciicast یا نشانی اینترنتی HTTP(S) برای بازپخش. می‌تواند یک مسیر پرونده محلی، یک نشانی HTTP(S) برای پرونده‌های دوردست، یا '-' برای خواندن از ورودی استاندارد باشد. نشانی‌های اینترنتی دوردست اجازه می‌دهند فایل‌های ضبط‌شده مستقیماً از وب و بدون نیاز به بارگیری دستی پخش شوند. قالب‌های پشتیبانی‌شده شامل نسخه‌های v1، v2 و v3 از asciicast هستند.

اطلاعات اضافی (EXTRA)

مثال‌ها:

asciinema play demo.cast
بازپخش یک پرونده ضبط‌شده محلی برای یک‌بار

asciinema play --speed 2.0 --loop demo.cast
بازپخش با دو برابر سرعت در یک چرخه تکرار

asciinema play --idle-time-limit 2 demo.cast
بازپخش با محدود کردن حداکثر زمان بیکاری به ۲ ثانیه

asciinema play https://asciinema.org/a/569727
بازپخش مستقیم از یک نشانی اینترنتی (URL)

asciinema play --pause-on-markers demo.cast
بازپخش، به همراه مکث خودکار در هر نشانه‌گذار