> ## Documentation Index
> Fetch the complete documentation index at: https://docs.youka.io/llms.txt
> Use this file to discover all available pages before exploring further.

# التصديرات

> تصيير وتنزيل تصديرات الكاريوكي في السحابة أو على الجهاز المحلي

التصدير هو مُخرَج مُصيَّر يتم إنتاجه من مشروع. تعمل التصديرات في السحابة افتراضيًا. مرّر `--local` للتصيير على جهازك باستخدام خط أنابيب Remotion المحلي.

## `export create`

قم بتصيير تصدير جديد لمشروع.

```bash theme={null}
youka export create <projectId> [options]
```

<ParamField path="projectId" type="string" required>
  المشروع المراد تصديره.
</ParamField>

### الخيارات

| Option                  | Description                                      |
| ----------------------- | ------------------------------------------------ |
| `--resolution <value>`  | `480p`, `720p`, `1080p`, أو `4k`                 |
| `--quality <value>`     | `low`, `medium`, أو `high`                       |
| `--speed <number>`      | مُضاعِف سرعة التشغيل                             |
| `--tone <number>`       | مُضاعِف إزاحة طبقة الصوت                         |
| `--transparent`         | التصيير بخلفية شفافة                             |
| `--preset <presetId>`   | تجاوز الـ Preset لهذا التصدير                    |
| `--volume <stem=value>` | تعيين مستوى صوت الـ stem حسب النوع. قابل للتكرار |
| `--local`               | التصيير محليًا بدلًا من السحابة                  |
| `--download`            | الانتظار حتى يكتمل التصدير وتنزيله               |
| `--output <path>`       | ملف أو مجلد الإخراج للتصيير المحلي أو للتنزيل    |

### مستويات صوت الـ stem

استخدم `--volume <type>=<value>`. الأنواع الصالحة هي `original` و`vocals` و`instrumental` و`backing_vocals`. يجب أن تكون القيم بين `0` و`1`.

### التصيير في السحابة

```bash theme={null}
youka export create $PROJECT_ID \
  --resolution 1080p \
  --quality high \
  --wait \
  --download \
  --output ./karaoke.mp4 \
  --json
```

### التصيير المحلي

التصيير المحلي يُشغّل خط أنابيب Remotion على جهازك. تأكد أولًا من تثبيت تبعيات التصيير:

```bash theme={null}
youka deps ensure --for render
```

ثم صدّر باستخدام `--local`:

```bash theme={null}
youka export create $PROJECT_ID \
  --local \
  --resolution 1080p \
  --output ./karaoke.mp4 \
  --json
```

<Note>
  تكتب التصييرات المحلية مباشرةً إلى مسار `--output`. لا تمرّر `--download`
  مع `--local`; ترفض واجهة CLI هذا الجمع لأنه لا يوجد مُخرَج سحابي
  لتنزيله بعد تصيير محلي.
</Note>

## `export quote`

احصل على تقدير للاعتمادات المطلوبة لتصدير سحابي دون بدء التصدير.

```bash theme={null}
youka export quote <projectId> [options]
```

`export quote` يقدّر فقط التصديرات السحابية. التصديرات المحلية تعمل على جهازك ولا
تستخدم اعتمادات التصدير السحابي.

| Option                  | Description                                      |
| ----------------------- | ------------------------------------------------ |
| `--resolution <value>`  | `480p`, `720p`, `1080p`, أو `4k`                 |
| `--quality <value>`     | `low`, `medium`, أو `high`                       |
| `--speed <number>`      | مُضاعِف سرعة التشغيل                             |
| `--tone <number>`       | مُضاعِف إزاحة طبقة الصوت                         |
| `--transparent`         | التصيير بخلفية شفافة                             |
| `--preset <presetId>`   | تجاوز الـ Preset لهذا التصدير                    |
| `--volume <stem=value>` | تعيين مستوى صوت الـ stem حسب النوع. قابل للتكرار |

مثال:

```bash theme={null}
youka export quote $PROJECT_ID \
  --resolution 1080p \
  --quality high \
  --json
```

## `export list`

اعرض قائمة التصديرات لمشروع.

```bash theme={null}
youka export list <projectId> [--page <n>] [--page-size <n>]
```

| Option        | Default | Description                    |
| ------------- | ------- | ------------------------------ |
| `--page`      | `1`     | رقم الصفحة.                    |
| `--page-size` | `100`   | حجم الصفحة. الحد الأقصى `100`. |

مثال:

```bash theme={null}
youka export list $PROJECT_ID --page-size 50 --json
```

## `export show`

اجلب تصديرًا واحدًا حسب المعرّف.

```bash theme={null}
youka export show <exportId>
youka export show <exportId> --json
```

## `export wait`

استطلع حالة تصدير حتى يصل إلى حالة نهائية.

```bash theme={null}
youka export wait <exportId> --json
```

## `export download`

نزّل تصديرًا موجودًا حسب المعرّف.

```bash theme={null}
youka export download <exportId> [--output <file>]
```

مثال:

```bash theme={null}
youka export download $EXPORT_ID \
  --output ./karaoke.mp4
```

## ما التالي

* [المشاريع](/ar/cli/projects) - أنشئ المشاريع أو انتظرها قبل التصدير
* [Presets](/ar/cli/presets) - أعد استخدام إعدادات التصيير عبر التصديرات
* [التبعيات](/ar/cli/deps) - افحص وثبّت تبعيات التصيير المحلي