# Пряма трансляція Cloud Phone

Відкритий або локальний API дозволяє завантажити один MP4-файл, почати трансляцію, перевірити статус і завершити її.

## Передумови

- Використовуйте сумісну модель; інші сервіси зараз повертають `33401`. Увімкніть Cloud Phone і отримайте OAuth2-токен із правом керування.
- Файл має бути у форматі MP4 і завантажуватися з `uploadType=2`.


## Процес для відкритого API

1. Викличте `POST /cloudphone/uploadUrl` і завантажте MP4 у `presignedUrl` через HTTP `PUT`.
2. Викличте `POST /cloudphone/uploadFile` з `uploadType: 2`.
3. Перевіряйте `POST /cloudphone/uploadFileResult`. Якщо `data` дорівнює `null`, продовжуйте опитування; зупиніться, коли `data.status` стане `1` (успіх) або `2` (помилка).
4. Передайте точне значення рядка `data.fileId` як `int64` у `POST /cloudphone/live/start`. У JavaScript використовуйте серіалізацію довільної точності й не перетворюйте значення через `Number`.
5. Використовуйте `/cloudphone/live/status` для перевірки та `/cloudphone/live/end` для завершення.


Для локального API використовуйте `/api/cloudphone/upload/file/signedUrl`, `/api/cloudphone/upload/file` з `uploadType: 2` і `/api/cloudphone/upload/file/result`, потім `/api/cloudphone/live/start`, `/status` або `/end`. Баланс і квоти доступні через `GET /api/balance`.

Повні схеми наведено у [відкритому](/uk/api-reference/cloud-phone/open-api) та [локальному API Cloud Phone](/uk/api-reference/cloud-phone/local-api). У разі тайм-ауту спочатку перевірте статус. Помилки трансляції: `33300`, `33301`, `33401`, `33418`, `99002`; API завантаження повертає `33419` для файлів не у форматі MP4.