.TH "SCRCPY" "1"
.SH "نام (NAME)"
scrcpy \- نمایش و کنترل دستگاه اندروید شما


.SH "خلاصه دستور (SYNOPSIS)"
.B scrcpy
.RI [ options ]


.SH "توضیحات (DESCRIPTION)"
.B scrcpy
قابلیت نمایش و کنترل دستگاه‌های Android متصل از طریق USB (یا بستر TCP/IP) را فراهم می‌کند. این ابزار به هیچ دسترسی ریشه (root) نیاز ندارد.


.SH "گزینه‌ها (OPTIONS)"

.TP
.B \-\-always\-on\-top
همواره نگه‌داشتن پنجره scrcpy در بالاترین لایه (روی سایر پنجره‌ها).

.TP
.BI "\-\-angle " degrees
چرخش محتوای ویدیو با یک زاویه سفارشی، برحسب درجه (در جهت عقربه‌های ساعت).

.TP
.BI "\-\-audio\-bit\-rate " value
کدگذاری صدا در نرخ بیت مشخص‌شده، برحسب بیت بر ثانیه (bits/s). پسوندهای یکا پشتیبانی می‌شوند: '\fBK\fR' (ضرب‌در ۱۰۰۰) و '\fBM\fR' (ضرب‌در ۱۰۰۰۰۰۰).

مقدار پیش‌فرض 128K (128000) است.

.TP
.BI "\-\-audio\-buffer " ms
پیکربندی تاخیر بافر صوتی (برحسب میلی‌ثانیه).

مقادیر کمتر تاخیر را کاهش می‌دهند، اما احتمال خالی شدن بافر (buffer underrun) را افزایش می‌دهند (که باعث ایجاد اختلال صوتی می‌شود).

مقدار پیش‌فرض 50 است.

.TP
.BI "\-\-audio\-codec " name
انتخاب یک کدک صوتی (opus، aac، flac یا raw).

مقدار پیش‌فرض opus است.

.TP
.BI "\-\-audio\-codec\-options " key\fR[:\fItype\fR]=\fIvalue\fR[,...]
تنظیم فهرستی از گزینه‌های جداشده با کاما به قالب key:type=value برای انکودر صوتی دستگاه.

مقادیر ممکن برای 'type' عبارتند از: 'int' (پیش‌فرض)، 'long'، 'float' و 'string'.

فهرست گزینه‌های کدک ممکن در مستندات Android در دسترس است:

<https://d.android.com/reference/android/media/MediaFormat>

.TP
.B \-\-audio\-dup
تکثیر صدا (ضبط و ادامه پخش روی دستگاه).

این قابلیت فقط همراه با --audio-source=playback در دسترس است.

.TP
.BI "\-\-audio\-encoder " name
استفاده از یک انکودر صوتی MediaCodec مشخص (بسته به کدک ارائه‌شده توسط \fB\-\-audio\-codec\fR).

انکودرهای در دسترس را می‌توان با \fB\-\-list\-encoders\fR فهرست کرد.

.TP
.BI "\-\-audio\-source " source
انتخاب منبع صوتی. مقادیر ممکن عبارتند از:

 - "output": کل خروجی صوتی را فوروارد می‌کند و پخش روی دستگاه را غیرفعال می‌سازد.
 - "playback": پخش صدا را ضبط می‌کند (برنامه‌های Android می‌توانند انصراف دهند، بنابراین لزوماً کل خروجی ضبط نمی‌شود).
 - "mic": صدای میکروفون را ضبط می‌کند.
 - "mic-unprocessed": صدای پردازش‌نشده (خام) میکروفون را ضبط می‌کند.
 - "mic-camcorder": صدای میکروفون تنظیم‌شده برای ضبط ویدیو را ضبط می‌کند، در صورت در دسترس بودن با همان جهت‌گیری دوربین.
 - "mic-voice-recognition": صدای میکروفون بهینه‌شده برای تشخیص گفتار را ضبط می‌کند.
 - "mic-voice-communication": صدای میکروفون بهینه‌شده برای ارتباط صوتی را ضبط می‌کند (برای مثال در صورت در دسترس بودن از حذف اکو یا کنترل خودکار بهره استفاده خواهد کرد).
 - "voice-call": تماس صوتی را ضبط می‌کند.
 - "voice-call-uplink": فقط ارسال تماس صوتی (uplink) را ضبط می‌کند.
 - "voice-call-downlink": فقط دریافت تماس صوتی (downlink) را ضبط می‌کند.
 - "voice-performance": صدایی را ضبط می‌کند که برای پردازش در اجرای زنده (کارائوکه) در نظر گرفته شده است، شامل هر دو صدای میکروفون و پخش دستگاه.

مقدار پیش‌فرض output است.

.TP
.BI "\-\-audio\-output\-buffer " ms
پیکربندی اندازه بافر خروجی صدای SDL (برحسب میلی‌ثانیه).

این تنظیم را تغییر ندهید مگر اینکه دلیل موجهی داشته باشید.

مقدار پیش‌فرض 10 است.

.TP
.BI "\-b, \-\-video\-bit\-rate " value
کدگذاری ویدیو در نرخ بیت مشخص‌شده، برحسب بیت بر ثانیه (bits/s). پسوندهای یکا پشتیبانی می‌شوند: '\fBK\fR' (ضرب‌در ۱۰۰۰) و '\fBM\fR' (ضرب‌در ۱۰۰۰۰۰۰).

مقدار پیش‌فرض 8M (8000000) است.

.TP
.BI "\-\-background-color " hexcolor
تنظیم رنگ پس‌زمینه، کدگذاری‌شده به‌صورت کد رنگ شانزده‌شانزدهی (#RGB یا #RRGGBB).

مقدار پیش‌فرض #222 (خاکستری تیره) است.

.TP
.BI "\-\-camera\-ar " ar
انتخاب اندازه دوربین بر اساس نسبت ابعاد آن (+/- ۱۰٪).

مقادیر ممکن عبارتند از "sensor" (استفاده از نسبت ابعاد حسگر دوربین)، "\fInum\fR:\fIden\fR" (مانند "4:3") و "\fIvalue\fR" (مانند "1.6").

.TP
.BI "\-\-camera\-facing " facing
انتخاب دوربین دستگاه بر اساس جهت‌گیری آن.

مقادیر ممکن عبارتند از "front"، "back" و "external".

.TP
.BI "\-\-camera\-fps " fps
مشخص کردن نرخ فریم تصویربرداری دوربین.

در صورت مشخص نشدن، از نرخ فریم پیش‌فرض Android (۳۰ فریم بر ثانیه) استفاده می‌شود.

.TP
.B \-\-camera\-high\-speed
فعال کردن حالت تصویربرداری با سرعت بالای دوربین.

این حالت محدود به تفکیک‌پذیری‌ها و نرخ‌های فریم خاصی است که با \fB\-\-list\-camera\-sizes\fR فهرست می‌شوند.

.TP
.BI "\-\-camera\-id " id
مشخص کردن شناسه دوربین دستگاه برای بازتاب.

شناسه‌های دوربین در دسترس را می‌توان با \fB\-\-list\-cameras\fR فهرست کرد.

.TP
.BI "\-\-camera\-size " width\fRx\fIheight
مشخص کردن اندازه دقیق تصویربرداری دوربین.

.TP
.BI \-\-camera\-torch
روشن کردن چراغ‌قوه دوربین هنگام شروع به کار دوربین.

.TP
.BI "\-\-camera-zoom " zoom
مشخص کردن مقدار بزرگ‌نمایی اولیه دوربین.

.TP
.BI "\-\-capture\-orientation " value
مقادیر ممکن عبارتند از 0، 90، 180، 270، flip0، flip90، flip180 و flip270، که احتمالاً با پیشوند '@' همراه هستند.

عدد نشان‌دهنده چرخش در جهت عقربه‌های ساعت برحسب درجه است؛ کلیدواژه "flip" قبل از چرخش یک قرینه‌سازی افقی اعمال می‌کند.

اگر برای تصویربرداری از نمایشگر یک '@' ابتدایی وارد شود (@90)، چرخش قفل شده و نسبت به جهت‌گیری طبیعی دستگاه سنجیده می‌شود.

اگر '@' به‌تنهایی وارد شود، چرخش روی جهت‌گیری اولیه دستگاه قفل می‌شود.

مقدار پیش‌فرض 0 است.

.TP
.BI "\-\-crop " width\fR:\fIheight\fR:\fIx\fR:\fIy
برش دادن صفحه نمایش دستگاه روی سرور.

مقادیر بر اساس جهت‌گیری طبیعی دستگاه بیان می‌شوند (به‌طور معمول، عمودی برای گوشی، افقی برای تبلت).

.TP
.B \-d, \-\-select\-usb
استفاده از دستگاه USB (اگر دقیقاً یکی وجود داشته باشد، مانند adb -d).

همچنین \fB\-e\fR (\fB\-\-select\-tcpip\fR) را ببینید.

.TP
.BI "\-\-disable\-screensaver"
غیرفعال کردن محافظ صفحه هنگام اجرای scrcpy.

.TP
.BI "\-\-display\-id " id
مشخص کردن شناسه نمایشگر دستگاه برای بازتاب.

شناسه‌های نمایشگر در دسترس را می‌توان با \fB\-\-list\-displays\fR فهرست کرد.

مقدار پیش‌فرض 0 است..TP
.BI "\-\-display\-ime\-policy " value
تنظیم خط‌مشی برای انتخاب مکان نمایش IME.

مقادیر ممکن عبارتند از "local"، "fallback" و "hide":

 - "local" به این معنی است که IME باید روی نمایشگر محلی ظاهر شود.
 - "fallback" به این معنی است که IME باید روی نمایشگر پشتیبان (نمایشگر پیش‌فرض) ظاهر شود.
 - "hide" به این معنی است که IME باید پنهان شود.

به طور پیش‌فرض، خط‌مشی IME بدون تغییر باقی می‌ماند.


.TP
.BI "\-\-display\-orientation " value
تنظیم جهت‌گیری اولیه نمایشگر.

مقادیر ممکن عبارتند از 0، 90، 180، 270، flip0، flip90، flip180 و flip270. عدد بیانگر چرخش در جهت عقربه‌های ساعت بر حسب درجه است؛ کلیدواژه "flip" قبل از چرخش، یک بازتاب افقی اعمال می‌کند.

پیش‌فرض 0 است.

.TP
.B \-e, \-\-select\-tcpip
استفاده از دستگاه TCP/IP (اگر دقیقاً یکی وجود داشته باشد، مانند adb -e).

همچنین \fB\-d\fR (\fB\-\-select\-usb\fR) را ببینید.

.TP
.B \-f, \-\-fullscreen
شروع در حالت تمام‌صفحه.

.TP
.B \-\-force\-adb\-forward
عدم تلاش برای استفاده از "adb reverse" جهت اتصال به دستگاه.

.TP
.B \-G
همانند \fB\-\-gamepad=uhid\fR، یا در صورت تنظیم \fB\-\-otg\fR، مانند \fB\-\-keyboard=aoa\fR است.

.TP
.BI "\-\-gamepad " mode
انتخاب نحوه ارسال ورودی‌های گیم‌پد به دستگاه.

مقادیر ممکن عبارتند از "disabled"، "uhid" و "aoa":

 - "disabled" ورودی‌های گیم‌پد را به دستگاه ارسال نمی‌کند.
 - "uhid" گیم‌پدهای فیزیکی HID را با استفاده از ماژول هسته HID لینوکس در دستگاه شبیه‌سازی می‌کند.
 - "aoa" گیم‌پدهای فیزیکی HID را با استفاده از پروتکل AOAv2 شبیه‌سازی می‌کند. این حالت ممکن است تنها از طریق USB کار کند.

همچنین \fB\-\-keyboard\fR و R\fB\-\-mouse\fR را ببینید.
.TP
.B \-h, \-\-help
چاپ این پیام راهنما.

.TP
.B \-\-ignore\-video\-encoder\-constraints
نادیده گرفتن قابلیت‌های انکودر ویدیو.

این گزینه در صورتی که قابلیت‌های گزارش‌شده نادرست باشند، مفید است.

ممکن است به اجبار یک مقدار برای \fB\-\-min\-size\-alignment\fR کمک کند.

.TP
.B \-K
همانند \fB\-\-keyboard=uhid\fR، یا در صورت تنظیم \fB\-\-otg\fR، مانند \fB\-\-keyboard=aoa\fR است.

.TP
.B \-\-keep\-active
روشن نگه داشتن صفحه نمایش با شبیه‌سازی فعالیت کاربر.

.TP
.BI "\-\-keyboard " mode
انتخاب نحوه ارسال ورودی‌های صفحه‌کلید به دستگاه.

مقادیر ممکن عبارتند از "disabled"، "sdk"، "uhid" و "aoa":

 - "disabled" ورودی‌های صفحه‌کلید را به دستگاه ارسال نمی‌کند.
 - "sdk" از API سیستم اندروید برای تحویل رویدادهای صفحه‌کلید به برنامه‌ها استفاده می‌کند.
 - "uhid" یک صفحه‌کلید فیزیکی HID را با استفاده از ماژول هسته HID لینوکس در دستگاه شبیه‌سازی می‌کند.
 - "aoa" یک صفحه‌کلید فیزیکی HID را با استفاده از پروتکل AOAv2 شبیه‌سازی می‌کند. این حالت ممکن است تنها از طریق USB کار کند.

برای "uhid" و "aoa"، چیدمان صفحه‌کلید باید (یک‌بار برای همیشه) در دستگاه، از طریق Settings -> System -> Languages and input -> Physical keyboard پیکربندی شود. این صفحه تنظیمات را می‌توان مستقیماً با استفاده از میانبر MOD+k (به جز در حالت OTG)، یا با اجرای دستور زیر باز کرد:

    adb shell am start -a android.settings.HARD_KEYBOARD_SETTINGS

این گزینه تنها زمانی در دسترس است که صفحه‌کلید HID فعال باشد (یا یک صفحه‌کلید فیزیکی متصل باشد).

همچنین \fB\-\-mouse\fR و \fB\-\-gamepad\fR را ببینید.

.TP
.B \-\-kill\-adb\-on\-close
خاتمه دادن به فرآیند adb هنگام بسته شدن scrcpy.

.TP
.B \-\-legacy\-paste
تزریق متن کلیپ‌بورد رایانه به صورت توالی‌ای از رویدادهای کلید هنگام فشرده شدن Ctrl+v (مانند MOD+Shift+v).

این یک راهکار برای برخی از دستگاه‌هایی است که هنگام تنظیم برنامه‌نویسی‌شده کلیپ‌بورد دستگاه، رفتار مورد انتظار را نشان نمی‌دهند.

.TP
.B \-\-list\-apps
فهرست کردن برنامه‌های اندروید نصب‌شده روی دستگاه.

.TP
.B \-\-list\-camera\-sizes
فهرست کردن اندازه‌های معتبر تصویربرداری دوربین.

.TP
.B \-\-list\-cameras
فهرست کردن دوربین‌های موجود روی دستگاه.

.TP
.B \-\-list\-encoders
فهرست کردن انکودرهای صدا و ویدیوی موجود روی دستگاه.

.TP
.B \-\-list\-displays
فهرست کردن نمایشگرهای موجود روی دستگاه.

.TP
.BI "\-m, \-\-max\-size " value
محدود کردن هم‌زمان عرض و ارتفاع ویدیو.

برای آینه‌کردن نمایشگر، بُعد دیگر به گونه‌ای محاسبه می‌شود که نسبت ابعاد دستگاه حفظ شود (به جز نمایشگرهای انعطاف‌پذیر).

برای آینه‌کردن دوربین، این مقدار در عوض برای انتخاب اندازه منبع دوربین استفاده می‌شود.

پیش‌فرض 0 (نامحدود) است.

.TP
.B \-M
همانند \fB\-\-mouse=uhid\fR، یا در صورت تنظیم \fB\-\-otg\fR، مانند \fB\-\-mouse=aoa\fR است.

.TP
.BI "\-\-max\-fps " value
محدود کردن نرخ فریم تصویربرداری از صفحه نمایش (به طور رسمی از اندروید 10 پشتیبانی می‌شود، اما ممکن است روی نسخه‌های قدیمی‌تر نیز کار کند).

.TP
.BI "\-\-min\-size\-alignment " alignment
پیکربندی حداقل هم‌ترازی اندازه ویدیو.

این مقداری از توان‌های 2 (1، 2، 4، 8 یا 16) است که عرض و ارتفاع ویدیو باید مضربی از آن باشند.

هم‌ترازی واقعی، بیشینهٔ این مقدار و الزامات هم‌ترازی کدک ویدیو خواهد بود.

پیش‌فرض 1 است.

.TP
.BI "\-\-mouse " mode
انتخاب نحوه ارسال ورودی‌های موشواره به دستگاه.

مقادیر ممکن عبارتند از "disabled"، "sdk"، "uhid" و "aoa":

 - "disabled" ورودی‌های موشواره را به دستگاه ارسال نمی‌کند.
 - "sdk" از API سیستم اندروید برای ارسال رویدادهای موشواره به برنامه‌ها استفاده می‌کند.
 - "uhid" یک موشواره فیزیکی HID را با استفاده از ماژول هسته HID لینوکس در دستگاه شبیه‌سازی می‌کند.
 - "aoa" یک موشواره فیزیکی را با استفاده از پروتکل AOAv2 شبیه‌سازی می‌کند. این حالت ممکن است تنها از طریق USB کار کند.

در حالت‌های "uhid" و "aoa"، موشواره رایانه برای کنترل مستقیم دستگاه ضبط می‌شود (حالت موشواره نسبی).

کلیدهای LAlt، LSuper یا RSuper حالت ضبط را تغییر می‌دهند تا کنترل موشواره به رایانه بازگردانده شود.

همچنین \fB\-\-keyboard\fR و \fB\-\-gamepad\fR را ببینید.

.TP
.BI "\-\-mouse\-bind " xxxx[:xxxx]
پیکربندی اتصالات کلیک‌های ثانویه.

آرگومان باید یک یا دو توالی (جداشده با ':') از دقیقاً 4 نویسه باشد، یکی برای هر کلیک ثانویه (به ترتیب: راست‌کلیک، کلیک وسط، کلیک چهارم، کلیک پنجم).

توالی اول اتصالات اولیه را تعیین می‌کند که هنگام فشرده شدن دکمه موشواره به تنهایی استفاده می‌شود. توالی دوم اتصالات ثانویه را تعیین می‌کند که هنگام فشرده شدن دکمه موشواره در حین نگه داشتن کلید Shift استفاده می‌شود.

اگر توالی دوم اتصالات نادیده گرفته شود، مانند توالی اول در نظر گرفته خواهد شد.

هر نویسه باید یکی از موارد زیر باشد:

 - '+': ارسال کلیک به دستگاه
 - '-': نادیده گرفتن کلیک
 - 'b': اجرای میانبر BACK (یا روشن کردن صفحه در صورت خاموش بودن)
 - 'h': اجرای میانبر HOME
 - 's': اجرای میانبر APP_SWITCH
 - 'n': اجرای میانبر "expand notification panel" (باز کردن پنل اعلان‌ها)

پیش‌فرض برای موشواره SDK مقدار 'bhsn:++++' و برای AOA و UHID مقدار '++++:bhsn' است..TP
.B \-n, \-\-no\-control
غیرفعال کردن کنترل دستگاه (آینه‌کردن دستگاه به‌صورت فقط‌خواندنی).

.TP
.B \-N, \-\-no\-playback
غیرفعال کردن پخش ویدیو و صدا در رایانه (معادل با \fB\-\-no\-video\-playback \-\-no\-audio\-playback\fR).

.TP
\fB\-\-new\-display\fR[=[\fIwidth\fRx\fIheight\fR][/\fIdpi\fR]]
ایجاد یک نمایشگر جدید با وضوح تصویر و تراکم مشخص‌شده. در صورت مشخص نشدن، به‌طور پیش‌فرض از ابعاد و DPI نمایشگر اصلی استفاده می‌شود.

مثال‌ها:

    \-\-new\-display=1920x1080
    \-\-new\-display=1920x1080/420
    \-\-new\-display         # اندازه و تراکم نمایشگر اصلی
    \-\-new\-display=/240    # اندازه نمایشگر اصلی و تراکم 240 dpi

.TP
.B \-\-no\-audio
غیرفعال کردن ارسال صدا.

.TP
.B \-\-no\-audio\-playback
غیرفعال کردن پخش صدا در رایانه.

.TP
.B \-\-no\-cleanup
به‌طور پیش‌فرض، scrcpy هنگام خروج، فایل باینری سرور را از دستگاه حذف کرده و وضعیت دستگاه (نمایش لمس‌ها، بیدار ماندن و حالت نیرو) را بازیابی می‌کند.

این گزینه این پاک‌سازی را غیرفعال می‌کند.

.TP
.B \-\-no\-clipboard\-autosync
به‌طور پیش‌فرض، scrcpy پیش از ارسال کلید‌های میانبر Ctrl+v به‌طور خودکار کلیپ‌بورد رایانه را با کلیپ‌بورد دستگاه، و در صورت هرگونه تغییر در کلیپ‌بورد دستگاه، آن را با کلیپ‌بورد رایانه همگام‌سازی می‌کند.

این گزینه این همگام‌سازی خودکار را غیرفعال می‌کند.

.TP
.B \-\-no\-downsize\-on\-error
به‌طور پیش‌فرض، هنگام بروز خطای MediaCodec، ابزار scrcpy به‌طور خودکار با وضوح تصویر پایین‌تر مجدداً تلاش می‌کند.

این گزینه این رفتار را غیرفعال می‌کند.

.TP
.B \-\-no\-key\-repeat
هنگام نگه‌داشتن یک کلید، رویدادهای تکرار کلید ارسال نشوند.

.TP
.B \-\-no\-mipmaps
اگر موتور رندر OpenGL 3.0+ یا OpenGL ES 2.0+ باشد، mipmapها به‌طور خودکار برای بهبود کیفیت مقیاس‌دهی به پایین (downscaling) تولید می‌شوند. این گزینه تولید mipmapها را غیرفعال می‌کند.

.TP
.B \-\-no\-mouse\-hover
رویدادهای حرکت شناور موش‌واره (حرکت موش‌واره بدون هیچ‌گونه کلیک) ارسال نشوند.

.TP
.B \-\-no\-power\-on
روشن نکردن دستگاه هنگام شروع.

.TP
.B \-\-no\-terminal\-title
غیرفعال کردن به‌روزرسانی عنوان ترمینال.

.TP
.B \-\-no\-vd\-destroy\-content
غیرفعال کردن پرچم «destroy content on removal» (حذف محتوا هنگام نابودی) در نمایشگر مجازی.

با این گزینه، هنگامی که نمایشگر مجازی بسته می‌شود، برنامه‌های در حال اجرا به جای بسته شدن به نمایشگر اصلی منتقل می‌شوند.

.TP
.B \-\-no\-vd\-system\-decorations
غیرفعال کردن پرچم تزئینات سیستمی (system decorations) نمایشگر مجازی.

.TP
.B \-\-no\-video
غیرفعال کردن ارسال ویدیو.

.TP
.B \-\-no\-video\-playback
غیرفعال کردن پخش ویدیو در رایانه.

.TP
.B \-\-no\-window
غیرفعال کردن پنجرهٔ scrcpy. مستلزم فعال بودن \-\-no\-video\-playback است.

.TP
.B \-\-no\-window\-aspect\-ratio\-lock
غیرفعال کردن قفل نسبت ابعاد پنجره.

.TP
.BI "\-\-orientation " value
مشابه با \-\-display\-orientation=value \-\-record\-orientation=value.

.TP
.B \-\-otg
اجرا در حالت OTG: شبیه‌سازی صفحه‌کلید و موش‌واره فیزیکی، درست مانند آن‌که صفحه‌کلید و موش‌واره رایانه مستقیماً از طریق یک کابل OTG به دستگاه متصل شده باشند.

در این حالت، نیازی به adb (اشکال‌زدایی USB) نبوده و آینه‌کردن تصویر غیرفعال است.

کلیدهای LAlt، LSuper یا RSuper حالت ضبط موش‌واره را تغییر وضعیت می‌دهند تا کنترل موش‌واره به رایانه بازگردانده شود.

صفحه‌کلید و موش‌واره را می‌توان به‌طور جداگانه با استفاده از \fB\-\-keyboard=disabled\fR و \fB\-\-mouse=disabled\fR غیرفعال کرد.

این ویژگی ممکن است فقط از طریق USB کار کند.

ببینید: \fB\-\-keyboard\fR، \fB\-\-mouse\fR و \fB\-\-gamepad\fR.

.TP
.BI "\-p, \-\-port " port\fR[:\fIport\fR]
تنظیم درگاه (محدوده درگاه) TCP مورد استفاده کلاینت برای شنود.

پیش‌فرض 27183:27199 است.

.TP
\fB\-\-pause\-on\-exit\fR[=\fImode\fR]
پیکربندی توقف در زمان خروج. مقادیر ممکن عبارتند از "true" (همیشه هنگام خروج مکث شود)، "false" (هرگز هنگام خروج مکث نشود) و "if-error" (مکث فقط در صورت وقوع خطا).

این گزینه برای جلوگیری از بسته شدن خودکار پنجرهٔ ترمینال مفید است تا بتوان پیام‌های خطا را مشاهده کرد.

پیش‌فرض "false" است.

ارسال این گزینه بدون آرگومان، معادل مشخص کردن "true" است.

.TP
.B \-\-power\-off\-on\-close
خاموش کردن صفحه نمایش دستگاه هنگام بستن scrcpy.

.TP
.B \-\-prefer\-text
تزریق نویسه‌های الفبایی و فاصله به‌صورت رویدادهای متنی (text events) به جای رویدادهای کلیدی (key events).

این کار از بروز مشکلات هنگام ترکیب چند کلید برای ورود نویسه‌های خاص جلوگیری می‌کند، اما رفتار مورد انتظار کلیدهای الفبایی را در بازی‌ها (معمولاً WASD) مختل می‌کند.

.TP
.B \-\-print\-fps
شروع شمارندهٔ FPS برای چاپ لاگ‌های نرخ فریم در کنسول. این کار را می‌توان در هر زمان با استفاده از کلیدهای MOD+i شروع یا متوقف کرد.

.TP
.BI "\-\-push\-target " path
تنظیم دایرکتوری مقصد برای فرستادن فایل‌ها به دستگاه با کشیدن و رها کردن (drag & drop). این مقدار بدون تغییر به "adb push" تحویل داده می‌شود.

پیش‌فرض "/sdcard/Download/" است.

.TP
.BI "\-r, \-\-record " file
ضبط صفحه نمایش در
.IR file .

فرمت ضبط توسط گزینهٔ
.B \-\-record\-format
در صورت تنظیم، یا بر اساس پسوند فایل تعیین می‌شود.

.TP
.B \-\-raw\-key\-events
تزریق رویدادهای کلیدی برای تمام کلیدهای ورودی و نادیده گرفتن رویدادهای متنی.

.TP
.BI "\-\-record\-format " format
اجبار به استفاده از فرمت ضبط (mp4، mkv، m4a، mka، opus، aac، flac یا wav).

.TP
.BI "\-\-record\-orientation " value
تنظیم جهت چرخش هنگام ضبط.

مقادیر ممکن عبارتند از 0، 90، 180 و 270. این عدد نشان‌دهندهٔ چرخش بر حسب درجه در جهت عقربه‌های ساعت است.

پیش‌فرض 0 است.

.TP
.BI "\-\-render\-driver " name
درخواست از SDL برای استفاده از درایور رندر داده‌شده (این گزینه صرفاً یک پیشنهاد است).

نام‌های پشتیبانی‌شده در حال حاضر عبارتند از "direct3d"، "opengl"، "opengles2"، "opengles"، "metal" و "software".

<https://wiki.libsdl.org/SDL_HINT_RENDER_DRIVER>

.TP
.BI "\-\-render\-fit " mode
تنظیم حالت render-fit برای پیکربندی نحوهٔ تطبیق رندر با پنجره.

مقادیر ممکن عبارتند از "letterbox"، "stretched" و "unscaled":

 - "letterbox": حفظ نسبت ابعاد و تطبیق دادن تصویر با پنجره به بهترین شکل ممکن (در صورت نیاز نوارهای سیاهی در بالا و پایین یا در طرفین اضافه می‌شود).
 - "stretched": پر کردن پنجره بدون حفظ نسبت تصویر.
 - "unscaled": رندر کردن تصویر نمایشگر بدون هیچ مقیاس‌بندی.

پیش‌فرض "letterbox" است، مگر اینکه گزینهٔ \-\-flex\-display تنظیم شده باشد که در این حالت "unscaled" خواهد بود..TP
.B \-\-require\-audio
به‌طور پیش‌فرض، اگر ضبط صدا در دستگاه ناموفق باشد، scrcpy فقط تصویر را آینه‌سازی (mirror) می‌کند. این گزینه باعث می‌شود در صورتی که صدا فعال باشد اما کار نکند، scrcpy با خطا متوقف شود.

.TP
.BI "\-s, \-\-serial " number
شماره سریال دستگاه. تنها در صورتی اجباری است که چندین دستگاه به adb متصل باشند.

.TP
.B \-S, \-\-turn\-screen\-off
صفحه نمایش دستگاه را فوراً خاموش می‌کند.

.TP
.B "\-\-screen\-off\-timeout " seconds
تنظیم مدت‌زمان وقفهٔ خاموش شدن صفحه نمایش در حین اجرای scrcpy (مقدار اولیه در زمان خروج بازگردانده می‌شود).

.TP
.BI "\-\-shortcut\-mod " key\fR[+...]][,...]
کلیدهای تغییردهنده (modifier) مورد استفاده برای میان‌برهای scrcpy را مشخص می‌کند. کلیدهای ممکن عبارت‌اند از "lctrl"، "rctrl"، "lalt"، "ralt"، "lsuper" و "rsuper".

می‌توان چندین کلید تغییردهنده میان‌بر را با جدا کردن توسط ',' تعیین کرد.

برای نمونه، جهت استفاده از LCtrl یا LSuper برای میان‌برهای scrcpy، مقدار "lctrl,lsuper" را بدهید.

پیش‌فرض "lalt,lsuper" است (Alt چپ یا Super چپ).

.TP
.BI "\-\-start\-app " name
یک برنامه اندروید را با نام دقیق بسته (package name) آن اجرا می‌کند.

افزودن پیشوند '?' برای انتخاب برنامه‌ای که نام آن با نام ارائه‌شده آغاز می‌شود، بدون حساسیت به بزرگی و کوچکی حروف (دریافت نام برنامه‌ها در دستگاه ممکن است کمی زمان ببرد):

    scrcpy --start-app=?firefox

افزودن پیشوند '+' برای توقف اجباری (force-stop) پیش از شروع برنامه:

    scrcpy --new-display --start-app=+org.mozilla.firefox

هر دو پیشوند را می‌توان به همین ترتیب با هم استفاده کرد:

    scrcpy --start-app=+?firefox

.TP
.B \-t, \-\-show\-touches
فعال‌سازی «نمایش لمس‌ها» در هنگام شروع، و بازگردانی مقدار اولیه در زمان خروج.

این گزینه فقط لمس‌های فیزیکی را نشان می‌دهد (نه کلیک‌های ناشی از scrcpy را).

.TP
.B \-\-tcpip\fR[=[+]\fIip\fR[:\fIport\fR]]
پیکربندی و اتصال دستگاه از طریق TCP/IP.

اگر نشانی مقصد مشخص شده باشد، scrcpy پیش از شروع به این نشانی متصل می‌شود. دستگاه باید روی درگاه TCP مشخص‌شده منتظر اتصال باشد (پیش‌فرض 5555 است).

اگر هیچ نشانی مقصدی داده نشود، scrcpy تلاش می‌کند تا نشانی IP و پورت adb دستگاه فعلی (معمولاً متصل از طریق USB) را بیابد، در صورت نیاز حالت TCP/IP را فعال کند، و سپس پیش از شروع به این نشانی متصل شود.

برای اجبار به برقراری اتصال مجدد، پیشوند '+' را قبل از نشانی قرار دهید.

.TP
.BI "\-\-time\-limit " seconds
حداکثر زمان آینه‌سازی را بر حسب ثانیه تنظیم می‌کند.

.TP
.BI "\-\-tunnel\-host " ip
نشانی IP تونل adb را برای دسترسی به سرور scrcpy تنظیم می‌کند. این گزینه به‌طور خودکار \fB\-\-force\-adb\-forward\fR را فعال می‌کند.

پیش‌فرض localhost است.

.TP
.BI "\-\-tunnel\-port " port
درگاه TCP تونل adb را برای دسترسی به سرور scrcpy تنظیم می‌کند. این گزینه به‌طور خودکار \fB\-\-force\-adb\-forward\fR را فعال می‌کند.

پیش‌فرض 0 است (اجباری نشده): از درگاه محلی استفاده‌شده برای برقراری تونل استفاده خواهد شد.

.TP
.B \-v, \-\-version
نسخهٔ scrcpy را چاپ می‌کند.

.TP
.BI "\-V, \-\-verbosity " value
سطح ثبت وقایع (log level) را تنظیم می‌کند ("verbose"، "debug"، "info"، "warn" یا "error").

پیش‌فرض برای بیلد‌های پایانی "info" و برای بیلد‌های اشکال‌زدایی "debug" است.

.TP
.BI "\-\-v4l2-sink " /dev/videoN
ارسال خروجی به دستگاه v4l2loopback.

.TP
.BI "\-\-v4l2-buffer " ms
افزودن تأخیر بافرینگ (بر حسب میلی‌ثانیه) پیش از ارسال فریم‌ها. این گزینه با افزایش تأخیر، نوسان و ناپایداری (jitter) را جبران می‌کند.

این گزینه مشابه \fB\-\-video\-buffer\fR است، اما مختص مقصد V4L2 می‌باشد.

پیش‌فرض 0 است (بدون بافرینگ).

.TP
.BI "\-\-video\-buffer " ms
افزودن تأخیر بافرینگ (بر حسب میلی‌ثانیه) پیش از نمایش فریم‌های ویدیو.

این کار با افزایش تأخیر، نوسان (jitter) را جبران می‌کند.

پیش‌فرض 0 است (بدون بافرینگ).

.TP
.BI "\-\-video\-codec " name
انتخاب یک کدک ویدیو (h264، h265، av1، vp8 یا vp9).

پیش‌فرض h264 است.

.TP
.BI "\-\-video\-codec\-options " key\fR[:\fItype\fR]=\fIvalue\fR[,...]
تنظیم فهرستی از گزینه‌ها به صورت key:type=value جداشده با کاما برای رمزگذار ویدیوی دستگاه.

مقادیر مجاز برای 'type' عبارت‌اند از 'int' (پیش‌فرض)، 'long'، 'float' و 'string'.

فهرست گزینه‌های ممکن کدک در مستندات اندروید موجود است:

<https://d.android.com/reference/android/media/MediaFormat>

.TP
.BI "\-\-video\-encoder " name
استفاده از یک رمزگذار ویدیوی MediaCodec خاص (بسته به کدک مشخص‌شده توسط \fB\-\-video\-codec\fR).

رمزگذارهای موجود را می‌توان با استفاده از \fB\-\-list\-encoders\fR فهرست کرد.

.TP
.BI "\-\-video\-source " source
انتخاب منبع ویدیو (display یا camera).

آینه‌سازی دوربین نیازمند اندروید ۱۲ یا بالاتر است.

پیش‌فرض display است.

.TP
.B \-w, \-\-stay-awake
روشن نگه داشتن دستگاه در حین اجرای scrcpy، هنگامی که دستگاه به برق متصل است.

.TP
.B \-\-window\-borderless
غیرفعال کردن حاشیه‌ها و تزیینات پنجره (نمایش پنجره بدون حاشیه).

.TP
.BI "\-\-window\-title " text
تنظیم عنوان سفارشی پنجره.

.TP
.BI "\-\-window\-x " value
تنظیم موقعیت افقی اولیه پنجره.

پیش‌فرض "auto" است.

.TP
.BI "\-\-window\-y " value
تنظیم موقعیت عمودی اولیه پنجره.

پیش‌فرض "auto" است.

.TP
.BI "\-\-window\-width " value
تنظیم عرض اولیه پنجره.

پیش‌فرض 0 است (خودکار).

.TP
.BI "\-\-window\-height " value
تنظیم ارتفاع اولیه پنجره.

پیش‌فرض 0 است (خودکار).

.TP
.B \-x, \-\-flex\-display
تغییر مداوم ابعاد نمایشگر مجازی برای مطابقت با پنجره..SH "وضعیت خروج (EXIT STATUS)"
.B scrcpy
در صورت خاتمه عادی برنامه با کد 0 خارج می‌شود. اگر برقراری اتصال اولیه
ممکن نباشد، کد خروج 1 بازگردانده خواهد شد. اگر دستگاه در حین فعال بودن یک
نشست قطع شود، کد خروج 2 بازگردانده می‌شود.

.SH "میانبرها (SHORTCUTS)"

در فهرست زیر، MOD کلید تبدیل (modifier) میانبر است. به‌طور پیش‌فرض، این کلید
Alt (چپ) یا Super (چپ) است، اما می‌توان آن را با \fB\-\-shortcut\-mod\fR پیکربندی کرد (به بالا مراجعه کنید).

.TP
.B MOD+q
خروج

.TP
.B MOD+f, F11
تغییر حالت تمام‌صفحه

.TP
.B MOD+Left
چرخاندن صفحه به چپ

.TP
.B MOD+Right
چرخاندن صفحه به راست

.TP
.B MOD+Shift+Left, MOD+Shift+Right
قرینه‌سازی افقی تصویر

.TP
.B MOD+Shift+Up, MOD+Shift+Down
قرینه‌سازی عمودی تصویر

.TP
.B MOD+z
مکث یا مکث مجدد تصویر

.TP
.B MOD+Shift+z
لغو مکث تصویر

.TP
.B MOD+Shift+r
بازنشانی ضبط/کدگذاری ویدیو

.TP
.B MOD+g
تغییر اندازه پنجره به نسبت 1:1 (دقت پیکسل به پیکسل)

.TP
.B MOD+w, Double\-click on black borders
تغییر اندازه پنجره برای حذف حاشیه‌های سیاه

.TP
.B MOD+h, Home, Middle\-click
کلیک روی HOME

.TP
.B MOD+b, MOD+Backspace, Right\-click (when screen is on)
کلیک روی BACK

.TP
.B MOD+s
کلیک روی APP_SWITCH

.TP
.B MOD+m
کلیک روی MENU

.TP
.B MOD+Up
کلیک روی VOLUME_UP

.TP
.B MOD+Down
کلیک روی VOLUME_DOWN

.TP
.B MOD+p
کلیک روی POWER (روشن/خاموش کردن صفحه)

.TP
.B Right\-click (when screen is off)
روشن کردن صفحه

.TP
.B MOD+o
خاموش کردن صفحه دستگاه (ادامه بازتاب)

.TP
.B MOD+Shift+o
روشن کردن صفحه دستگاه

.TP
.B MOD+r
چرخاندن صفحه دستگاه

.TP
.B MOD+n
باز کردن پنل اعلان‌ها

.TP
.B MOD+Shift+n
بستن پنل اعلان‌ها

.TP
.B Mod+c
رونوشت در حافظه موقت (ارسال کد کلید COPY، تنها در Android >= 7)

.TP
.B Mod+x
برش در حافظه موقت (ارسال کد کلید CUT، تنها در Android >= 7)

.TP
.B MOD+v
رونوشت از حافظه موقت رایانه به دستگاه، سپس چسباندن (ارسال کد کلید PASTE، تنها در Android >= 7)

.TP
.B MOD+Shift+v
ارسال متن حافظه موقت رایانه به‌صورت توالی‌ای از رویدادهای کلید

.TP
.B MOD+k
باز کردن تنظیمات صفحه‌کلید در دستگاه (تنها برای صفحه‌کلید HID)

.TP
.B MOD+i
فعال/غیرفعال کردن شمارنده FPS (چاپ فریم در ثانیه در لاگ‌ها)

.TP
.B Ctrl+click-and-move
بزرگ‌نمایی با دو انگشت (Pinch-to-zoom) و چرخش از مرکز صفحه

.TP
.B Shift+click-and-move
شیب دادن عمودی (لغزاندن با ۲ انگشت)

.TP
.B Ctrl+Shift+click-and-move
شیب دادن افقی (لغزاندن با ۲ انگشت)

.TP
.B Drag & drop APK file
نصب APK از رایانه

.TP
.B Drag & drop non-APK file
انتقال فایل به دستگاه (نگاه کنید به \fB\-\-push\-target\fR)

.TP
.B MOD+t
روشن کردن چراغ‌قوه دوربین (تنها در حالت دوربین)

.TP
.B MOD+Shift+t
خاموش کردن چراغ‌قوه دوربین (تنها در حالت دوربین)

.TP
.B MOD+Up
بزرگ‌نمایی دوربین به جلو (تنها در حالت دوربین)

.TP
.B MOD+Down
بزرگ‌نمایی دوربین به عقب (تنها در حالت دوربین).SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"

.TP
.B ADB
مسیر adb.

.TP
.B ANDROID_SERIAL
شماره سریال دستگاه برای استفاده در صورتی که هیچ انتخاب‌گری (\fB-s\fR، \fB-d\fR، \fB-e\fR یا \fB\-\-tcpip=\fIaddr\fR) مشخص نشده باشد.

.TP
.B SCRCPY_ICON_DIR
مسیر دایرکتوری آیکون.

.TP
.B SCRCPY_SERVER_PATH
مسیر فایل باینری سرور.


.SH "نویسندگان (AUTHORS)"
.B scrcpy
توسط Romain Vimont نوشته شده است.

این صفحهٔ راهنما توسط
.MT mmyangfl@gmail.com
Yangfl
.ME
برای پروژهٔ Debian نوشته شده است (و می‌تواند توسط دیگران نیز استفاده شود).


.SH "گزارش باگ‌ها (REPORTING BUGS)"
باگ‌ها را به <https://github.com/Genymobile/scrcpy/issues> گزارش دهید.

.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
حق نشر \(co 2018 Genymobile <https://www.genymobile.com>

حق نشر \(co 2018\-2026 Romain Vimont <rom@rom1v.com>

تحت پروانهٔ Apache License، نسخهٔ 2.0 منتشر شده است.

.SH WWW
<https://github.com/Genymobile/scrcpy>