aboutsummaryrefslogtreecommitdiff
path: root/files/fa/web/api/mediatrackconstraints/index.html
diff options
context:
space:
mode:
Diffstat (limited to 'files/fa/web/api/mediatrackconstraints/index.html')
-rw-r--r--files/fa/web/api/mediatrackconstraints/index.html264
1 files changed, 264 insertions, 0 deletions
diff --git a/files/fa/web/api/mediatrackconstraints/index.html b/files/fa/web/api/mediatrackconstraints/index.html
new file mode 100644
index 0000000000..11f3c9e37f
--- /dev/null
+++ b/files/fa/web/api/mediatrackconstraints/index.html
@@ -0,0 +1,264 @@
+---
+title: MediaTrackConstraints
+slug: Web/API/MediaTrackConstraints
+translation_of: Web/API/MediaTrackConstraints
+---
+<div><font><font>{{APIRef ("ضبط رسانه و جریان")}}</font></font></div>
+
+<p><strong><code>MediaTrackConstraints</code></strong><font><font>فرهنگ لغت استفاده می شود برای توصیف مجموعه ای از قابلیت ها و ارزش یا ارزش هر یک می تواند در را. </font><font>یک فرهنگ لغت محدودیتی به {{domxref ("MediaStreamTrack.applyConstraints"، "applyConstraints ()")}}}} منتقل می شود تا یک اسکریپت بتواند مجموعه ای از مقادیر یا محدوده دقیق (موردنیاز) یا مقادیر یا محدوده های مورد نظر برای مسیر و مجموعه اخیر محدودیت های سفارشی درخواست شده توسط {{domxref ("MediaStreamTrack.getConstraints"، "getConstraints ()")}}} بازیابی می شود.</font></font></p>
+
+<p><font><font>برای هر محدودیت، می توانید به طور معمول مقدار دقیق مورد نیاز خود را، ارزش ایده آل که می خواهید، محدوده ای از مقادیر قابل قبول و / یا یک مقدار که می خواهید تا حد ممکن نزدیک باشد، مشخص کنید. </font><font>خصوصیات بسته به نوع ملک محدود می شود.</font></font></p>
+
+<p>To learn more about how constraints work, see <a href="/en-US/docs/Web/API/Media_Streams_API/Constraints">Capabilities, constraints, and settings</a>.</p>
+
+<h2 id="Properties">Properties</h2>
+
+<p>Some combination—but not necessarily all—of the following properties will exist on the object.</p>
+
+<h3 id="Properties_of_all_media_tracks">Properties of all media tracks</h3>
+
+<dl>
+ <dt>{{domxref("MediaTrackConstraints.deviceId", "deviceId")}}</dt>
+ <dd>A {{domxref("ConstrainDOMString")}} object specifying a device ID or an array of device IDs which are acceptable and/or required.</dd>
+ <dt>{{domxref("MediaTrackConstraints.groupId", "groupId")}}</dt>
+ <dd>A {{domxref("ConstrainDOMString")}} object specifying a group ID or an array of group IDs which are acceptable and/or required.</dd>
+</dl>
+
+<h3 id="Properties_of_audio_tracks">Properties of audio tracks</h3>
+
+<dl>
+ <dt>{{domxref("MediaTrackConstraints.autoGainControl", "autoGainControl")}}</dt>
+ <dd>A {{domxref("ConstrainBoolean")}} object which specifies whether automatic gain control is preferred and/or required.</dd>
+ <dt>{{domxref("MediaTrackConstraints.channelCount", "channelCount")}}</dt>
+ <dd>A {{domxref("ConstrainLong")}} specifying the channel count or range of channel counts which are acceptable and/or required.</dd>
+ <dt>{{domxref("MediaTrackConstraints.echoCancellation", "echoCancellation")}}</dt>
+ <dd>A {{domxref("ConstrainBoolean")}} object specifying whether or not echo cancellation is preferred and/or required.</dd>
+ <dt>{{domxref("MediaTrackConstraints.latency", "latency")}}</dt>
+ <dd>A {{domxref("ConstrainDouble")}} specifying the latency or range of latencies which are acceptable and/or required.</dd>
+ <dt>{{domxref("MediaTrackConstraints.noiseSuppression", "noiseSuppression")}}</dt>
+ <dd>A {{domxref("ConstrainBoolean")}} which specifies whether noise suppression is preferred and/or required.</dd>
+ <dt>{{domxref("MediaTrackConstraints.sampleRate", "sampleRate")}}</dt>
+ <dd>A {{domxref("ConstrainLong")}} specifying the sample rate or range of sample rates which are acceptable and/or required.</dd>
+ <dt>{{domxref("MediaTrackConstraints.sampleSize", "sampleSize")}}</dt>
+ <dd>A {{domxref("ConstrainLong")}} specifying the sample size or range of sample sizes which are acceptable and/or required.</dd>
+ <dt>{{domxref("MediaTrackConstraints.volume", "volume")}}</dt>
+ <dd>A {{domxref("ConstrainDouble")}} specifying the volume or range of volumes which are acceptable and/or required.</dd>
+</dl>
+
+<h3 id="Properties_of_image_tracks">Properties of image tracks</h3>
+
+<dl>
+ <dt>{{domxref("MediaTrackConstraints.whiteBalanceMode","whiteBalanceMode")}}</dt>
+ <dd>A {{jsxref("String")}} specifying one of <code>"none"</code>, <code>"manual"</code>, <code>"sigle-shot"</code>, or <code>"continuous"</code>.</dd>
+ <dt>{{domxref("MediaTrackConstraints.exposureMode","exposureMode")}}</dt>
+ <dd>A {{jsxref("String")}} specifying one of <code>"none"</code>, <code>"manual"</code>, <code>"sigle-shot"</code>, or <code>"continuous"</code>.</dd>
+ <dt>{{domxref("MediaTrackConstraints.focusMode","focusMode")}}</dt>
+ <dd>A {{jsxref("String")}} specifying one of <code>"none"</code>, <code>"manual"</code>, <code>"sigle-shot"</code>, or <code>"continuous"</code>.</dd>
+ <dt>{{domxref("MediaTrackConstraints.pointsOfInterest","pointsOfInterest")}}</dt>
+ <dd>The pixel coordinates on the sensor of one or more points of interest. This is either an object in the form { x:<em>value</em>, y:<em>value</em> } or an array of such objects, where <em>value </em> is a double-precision integer.</dd>
+ <dt>{{domxref("MediaTrackConstraints.expsureCompensation","exposureCompensation")}}</dt>
+ <dd>A {{domxref("ConstrainDouble")}} (a double-precision integer) specifying f-stop adjustment by up to ±3. </dd>
+ <dt>{{domxref("MediaTrackConstraints.colorTemperature","colorTemperature")}}</dt>
+ <dd>A {{domxref("ConstrainDouble")}} (a double-precision integer) specifying a desired color temperature in degrees kelvin.</dd>
+ <dt>{{domxref("MediaTrackConstraints.iso","iso")}}</dt>
+ <dd>A {{domxref("ConstrainDouble")}} (a double-precision integer) specifying a desired iso setting.</dd>
+ <dt>{{domxref("MediaTrackConstraints.brightness","brightness")}}</dt>
+ <dd>A {{domxref("ConstrainDouble")}} (a double-precision integer) specifying a desired brightness setting.</dd>
+ <dt>{{domxref("MediaTrackConstraints.contrast","contrast")}}</dt>
+ <dd>A {{domxref("ConstrainDouble")}} (a double-precision integer) specifying the degree of difference between light and dark.</dd>
+ <dt>{{domxref("MediaTrackConstraints.saturation","saturation")}}</dt>
+ <dd>A {{domxref("ConstrainDouble")}} (a double-precision integer) specifying the degree of color intensity.</dd>
+ <dt>{{domxref("MediaTrackConstraints.sharpness","sharpness")}}</dt>
+ <dd>A {{domxref("ConstrainDouble")}} (a double-precision integer) specifying the intensity of edges.</dd>
+ <dt>{{domxref("MediaTrackConstraints.focusDistance","focusDistance")}}</dt>
+ <dd>A {{domxref("ConstrainDouble")}} (a double-precision integer) specifying distance to a focused object.</dd>
+ <dt>{{domxref("MediaTrackConstraints.zoom","zoom")}}</dt>
+ <dd>A {{domxref("ConstrainDouble")}} (a double-precision integer) specifying the desired focal length.</dd>
+ <dt>{{domxref("MediaTrackConstraints.torch","torch")}}</dt>
+ <dd>A {{jsxref("Boolean")}} whter the fill light continuously connected, meaning it stays on as long as the track is active.</dd>
+</dl>
+
+<h3 id="Properties_of_video_tracks">Properties of video tracks</h3>
+
+<dl>
+ <dt>{{domxref("MediaTrackConstraints.aspectRatio", "aspectRatio")}}</dt>
+ <dd>A {{domxref("ConstrainDouble")}} specifying the video aspect ratio or range of aspect ratios which are acceptable and/or required.</dd>
+ <dt>{{domxref("MediaTrackConstraints.facingMode", "facingMode")}}</dt>
+ <dd>A {{domxref("ConstrainDOMString")}} object specifying a facing or an array of facings which are acceptable and/or required.</dd>
+ <dt>{{domxref("MediaTrackConstraints.frameRate", "frameRate")}}</dt>
+ <dd><font><font>A {{domxref ("ConstrainDouble")}} تعیین نرخ فریم یا دامنه نرخ فریم که قابل قبول و / یا مورد نیاز است.</font></font></dd>
+ <dt><font><font>{{domxref ("MediaTrackConstraints.height"، "height")}}</font></font></dt>
+ <dd><font><font>A {{domxref ("ConstrainLong")}} تعیین ارتفاع ویدیو یا محدوده ارتفاع که قابل قبول و / یا مورد نیاز است.</font></font></dd>
+ <dt><font><font>{{domxref ("MediaTrackConstraints.width"، "width")}}</font></font></dt>
+ <dd><font><font>A {{domxref ("ConstrainLong")}} مشخص کردن عرض ویدئو یا طیف وسیعی از عرض که قابل قبول و / یا مورد نیاز است.</font></font></dd>
+</dl>
+
+<h2 id="مشخصات_فنی"><font><font>مشخصات فنی</font></font></h2>
+
+<table class="standard-table">
+ <tbody>
+ <tr>
+ <th scope="col"><font><font>مشخصات</font></font></th>
+ <th scope="col"><font><font>وضعیت</font></font></th>
+ <th scope="col"><font><font>اظهار نظر</font></font></th>
+ </tr>
+ <tr>
+ <td><font><font>{{SpecName ('Media Capture'، '# dom-mediatrackconstraints'، 'applyConstraints ()')}}</font></font></td>
+ <td><font><font>{{Spec2 ('رسانه ضبط')}}</font></font></td>
+ <td><font><font>تعریف اولیه</font></font></td>
+ </tr>
+ <tr>
+ <td><font><font>{{SpecName ('MediaStream تصویر'، '# mediatrackconstraintset-section'، 'applyConstraints ()')}}</font></font></td>
+ <td><font><font>{{Spec2 ('MediaStream Image')}}</font></font></td>
+ <td><font><font>محدودیت های تصویر را اضافه می کند.</font></font></td>
+ </tr>
+ </tbody>
+</table>
+
+<h2 id="سازگاری_مرورگر"><font><font>سازگاری مرورگر</font></font></h2>
+
+<p><font><font>{{CompatibilityTable}}</font></font></p>
+
+<div id="compat-desktop">
+<table class="compat-table">
+ <tbody>
+ <tr>
+ <th><font><font>ویژگی</font></font></th>
+ <th><font><font>کروم</font></font></th>
+ <th><font><font>فایرفاکس (Gecko)</font></font></th>
+ <th><font><font>اینترنت اکسپلورر</font></font></th>
+ <th><font><font>اپرا</font></font></th>
+ <th><font><font>سافاری</font></font></th>
+ </tr>
+ <tr>
+ <td><font><font>پشتیبانی پایه</font></font></td>
+ <td><font><font>{{CompatChrome (59)}}</font></font></td>
+ <td><font><font>{{CompatUnknown}}</font></font></td>
+ <td><font><font>{{CompatUnknown}}</font></font></td>
+ <td><font><font>{{CompatOpera (46)}}</font></font></td>
+ <td><font><font>{{CompatUnknown}}</font></font></td>
+ </tr>
+ <tr>
+ <td><code>deviceId</code></td>
+ <td><font><font>{{CompatChrome (59)}}</font></font></td>
+ <td><font><font>{{CompatUnknown}}</font></font></td>
+ <td><font><font>{{CompatUnknown}}</font></font></td>
+ <td><font><font>{{CompatOpera (46)}}</font></font></td>
+ <td><font><font>{{CompatUnknown}}</font></font></td>
+ </tr>
+ <tr>
+ <td><code>groupId</code></td>
+ <td><font><font>{{CompatChrome (59)}}</font></font></td>
+ <td><font><font>{{CompatUnknown}}</font></font></td>
+ <td><font><font>{{CompatUnknown}}</font></font></td>
+ <td><font><font>{{CompatOpera (46)}}</font></font></td>
+ <td><font><font>{{CompatUnknown}}</font></font></td>
+ </tr>
+ <tr>
+ <td><font><font>خواص آهنگ صوتی</font></font></td>
+ <td><font><font>{{CompatNo}}</font></font></td>
+ <td><font><font>{{CompatUnknown}}</font></font></td>
+ <td><font><font>{{CompatUnknown}}</font></font></td>
+ <td><font><font>{{CompatNo}}</font></font></td>
+ <td><font><font>{{CompatUnknown}}</font></font></td>
+ </tr>
+ <tr>
+ <td><font><font>خواص مسیر تصویر</font></font></td>
+ <td><font><font>{{CompatChrome (63)}}</font></font></td>
+ <td><font><font>{{CompatUnknown}}</font></font></td>
+ <td><font><font>{{CompatUnknown}}</font></font></td>
+ <td><font><font>{{CompatOpera (50)}}</font></font></td>
+ <td><font><font>{{CompatUnknown}}</font></font></td>
+ </tr>
+ <tr>
+ <td><font><font>خواص آهنگ های ویدئویی</font></font></td>
+ <td><font><font>{{CompatChrome (59)}}</font></font></td>
+ <td><font><font>{{CompatUnknown}}</font></font></td>
+ <td><font><font>{{CompatUnknown}}</font></font></td>
+ <td><font><font>{{CompatOpera (46)}}</font></font></td>
+ <td><font><font>{{CompatUnknown}}</font></font></td>
+ </tr>
+ </tbody>
+</table>
+</div>
+
+<div id="compat-mobile">
+<table class="compat-table">
+ <tbody>
+ <tr>
+ <th><font><font>ویژگی</font></font></th>
+ <th><font><font>Android Webview</font></font></th>
+ <th><font><font>Chrome برای آندروید</font></font></th>
+ <th><font><font>فایرفاکس موبایل (Gecko)</font></font></th>
+ <th><font><font>اینترنت اکسپلورر</font></font></th>
+ <th><font><font>اپرا موبایل</font></font></th>
+ <th><font><font>سافاری موبایل</font></font></th>
+ </tr>
+ <tr>
+ <td><font><font>پشتیبانی پایه</font></font></td>
+ <td><font><font>{{CompatChrome (59)}}</font></font></td>
+ <td><font><font>{{CompatChrome (59)}}</font></font></td>
+ <td><font><font>{{CompatUnknown}}</font></font></td>
+ <td><font><font>{{CompatUnknown}}</font></font></td>
+ <td><font><font>{{CompatOperaMobile (46)}}</font></font></td>
+ <td><font><font>{{CompatUnknown}}</font></font></td>
+ </tr>
+ <tr>
+ <td><code>deviceId</code></td>
+ <td><font><font>{{CompatChrome (59)}}</font></font></td>
+ <td><font><font>{{CompatChrome (59)}}</font></font></td>
+ <td><font><font>{{CompatUnknown}}</font></font></td>
+ <td><font><font>{{CompatUnknown}}</font></font></td>
+ <td><font><font>{{CompatOperaMobile (46)}}</font></font></td>
+ <td><font><font>{{CompatUnknown}}</font></font></td>
+ </tr>
+ <tr>
+ <td><code>groupId</code></td>
+ <td><font><font>{{CompatChrome (59)}}</font></font></td>
+ <td><font><font>{{CompatChrome (59)}}</font></font></td>
+ <td><font><font>{{CompatUnknown}}</font></font></td>
+ <td><font><font>{{CompatUnknown}}</font></font></td>
+ <td><font><font>{{CompatOperaMobile (46)}}</font></font></td>
+ <td><font><font>{{CompatUnknown}}</font></font></td>
+ </tr>
+ <tr>
+ <td><font><font>خواص آهنگ صوتی</font></font></td>
+ <td><font><font>{{CompatNo}}</font></font></td>
+ <td><font><font>{{CompatNo}}</font></font></td>
+ <td><font><font>{{CompatUnknown}}</font></font></td>
+ <td><font><font>{{CompatUnknown}}</font></font></td>
+ <td><font><font>{{CompatNo}}</font></font></td>
+ <td><font><font>{{CompatUnknown}}</font></font></td>
+ </tr>
+ <tr>
+ <td><font><font>خواص مسیر تصویر</font></font></td>
+ <td><font><font>{{CompatChrome (63)}}</font></font></td>
+ <td><font><font>{{CompatChrome (63)}}</font></font></td>
+ <td><font><font>{{CompatUnknown}}</font></font></td>
+ <td><font><font>{{CompatUnknown}}</font></font></td>
+ <td><font><font>{{CompatOperaMobile (50)}}</font></font></td>
+ <td><font><font>{{CompatUnknown}}</font></font></td>
+ </tr>
+ <tr>
+ <td><font><font>خواص آهنگ های ویدئویی</font></font></td>
+ <td><font><font>{{CompatChrome (59)}}</font></font></td>
+ <td><font><font>{{CompatChrome (59)}}</font></font></td>
+ <td><font><font>{{CompatUnknown}}</font></font></td>
+ <td><font><font>{{CompatUnknown}}</font></font></td>
+ <td><font><font>{{CompatOperaMobile (46)}}</font></font></td>
+ <td><font><font>{{CompatUnknown}}</font></font></td>
+ </tr>
+ </tbody>
+</table>
+</div>
+
+<h2 id="همچنین_نگاه_کنید"><font><font>همچنین نگاه کنید</font></font></h2>
+
+<ul>
+ <li><font><font>{{domxref ("MediaDevices.getUserMedia ()")}}</font></font></li>
+ <li><font><font>{{domxref ("MediaStreamTrack.getConstraints ()")}}</font></font></li>
+ <li><font><font>{{domxref ("MediaStreamTrack.applyConstraints ()")}}</font></font></li>
+ <li><font><font>{{domxref ("MediaDevices.getSupportedConstraints ()")}}</font></font></li>
+ <li><font><font>{{domxref ("MediaTrackSupportedConstraints")}}</font></font></li>
+ <li><font><font>{{domxref ("MediaStreamTrack.getSettings ()")}}</font></font></li>
+</ul>