Ресурс liveStream содержит информацию о видеопотоке, который вы передаете на YouTube. Поток предоставляет контент, который будет транслироваться пользователям YouTube. После создания ресурс liveStream можно привязать к одному или нескольким ресурсам liveBroadcast .
Методы
API поддерживает следующие методы для ресурсов liveStreams :
- list
- Возвращает список видеопотоков, соответствующих параметрам запроса API. Попробуйте сейчас .
- insert
- Создает видеопоток. Поток позволяет вам отправлять видео на YouTube, который затем может транслировать видео вашей аудитории. Попробуйте сейчас .
- update
- Обновляет видеопоток. Если свойства, которые вы хотите изменить, не могут быть обновлены, то вам нужно создать новый поток с правильными настройками. Попробуйте сейчас .
- delete
- Удаляет видеопоток. Попробуйте сейчас .
Представление ресурсов
Следующая структура JSON показывает формат ресурса liveStreams :
{
"kind": "youtube#liveStream",
"etag": etag,
"id": string,
"snippet": {
"publishedAt": datetime,
"channelId": string,
"title": string,
"description": string,
"isDefaultStream": boolean
},
"cdn": {
"ingestionType": string,
"ingestionInfo": {
"streamName": string,
"ingestionAddress": string,
"backupIngestionAddress": string
},
"resolution": string,
"frameRate": string
},
"status": {
"streamStatus": string,
"healthStatus": {
"status": string,
"lastUpdateTimeSeconds": unsigned long,
"configurationIssues": [
{
"type": string,
"severity": string,
"reason": string,
"description": string
}
]
}
},
"contentDetails": {
"closedCaptionsIngestionUrl": string,
"isReusable": boolean
}
}Характеристики
В следующей таблице определены свойства, которые отображаются в этом ресурсе:
| Характеристики | |
|---|---|
kind | stringОпределяет тип ресурса API. Значение будет youtube#liveStream . |
etag | etagEtag этого ресурса. |
id | stringИдентификатор, который YouTube назначает для уникальной идентификации трансляции. |
snippet | objectОбъект snippet содержит основные сведения о потоке, включая его канал, название и описание. |
snippet. publishedAt | datetimeДата и время создания потока. Значение указывается в формате ISO 8601 ( YYYY-MM-DDThh:mm:ss.sZ ). |
snippet. channelId | stringИдентификатор, который YouTube использует для уникальной идентификации канала, транслирующего поток. |
snippet. title | stringНазвание потока. Значение должно быть длиной от 1 до 128 символов. |
snippet. description | stringОписание потока. Значение не может быть длиннее 10000 символов. |
snippet. isDefaultStream | boolean Это свойство будет упразднено 1 сентября 2020 года или позже. В это время YouTube прекратит создавать поток по умолчанию и трансляцию по умолчанию, когда канал будет включен для прямой трансляции. Пожалуйста, ознакомьтесь с объявлением об упразднении для получения более подробной информации. Это свойство указывает, является ли данный поток потоком по умолчанию для канала.Как работают потоки по умолчанию Когда канал YouTube включен для прямой трансляции, YouTube создает поток по умолчанию и трансляцию по умолчанию для канала. Поток определяет, как владелец канала отправляет живое видео на YouTube, а трансляция — как зрители могут видеть поток по умолчанию. Владелец канала может использовать методы liveStreams.list и liveBroadcasts.list для идентификации этих ресурсов.Поток канала по умолчанию существует неограниченно, не имеет начального или конечного времени, связанного с ним, и не может быть удален. Владельцу канала нужно только начать отправлять видеобиты, и поток продолжится автоматически. Когда поток заканчивается, YouTube конвертирует завершенную трансляцию в видео YouTube и присваивает видео идентификатор видео YouTube. После завершения конвертации видео включается в список загруженных видео канала. Видео недоступно сразу после завершения трансляции, а длительность задержки связана с фактической длительностью трансляции. |
cdn | objectОбъект cdn определяет настройки сети доставки контента (CDN) для прямой трансляции. Эти настройки предоставляют сведения о том, как вы транслируете свой контент на YouTube. |
cdn. format | stringЭто свойство устарело с 18 апреля 2016 года и больше не будет поддерживаться с 17 августа 2020 года. Запросы, которые по состоянию на эту дату все еще используют это свойство, не будут выполнены. Вместо этого используйте свойства cdn.frameRate и cdn.resolution , чтобы указать частоту кадров и разрешение по отдельности. |
cdn. ingestionType | stringМетод или протокол, используемый для передачи видеопотока. Допустимые значения для этого свойства:
|
cdn. ingestionInfo | objectОбъект ingestionInfo содержит информацию, которую предоставляет YouTube и которая необходима для передачи вашего потока на YouTube. |
cdn.ingestionInfo. streamName | stringИмя потока, которое YouTube присваивает видеопотоку. |
cdn.ingestionInfo. ingestionAddress | stringОсновной URL-адрес приема, который следует использовать для потоковой передачи видео на YouTube, если вы используете RTMP, DASH или HLS. Вы должны транслировать видео на этот URL-адрес. В зависимости от того, какое приложение или инструмент вы используете для кодирования видеопотока, вам может потребоваться ввести URL-адрес потока и имя потока по отдельности или объединить их в следующем формате: STREAM_URL/STREAM_NAME |
cdn.ingestionInfo. backupIngestionAddress | stringРезервный URL-адрес приема, который следует использовать для потоковой передачи видео на YouTube, если вы используете RTMP, DASH или HLS. У вас есть возможность одновременной потоковой передачи контента, который вы отправляете на ingestionAddress , на этот URL-адрес. |
cdn.ingestionInfo. rtmpsIngestionAddress | stringОсновной URL-адрес для приема, который следует использовать для потоковой передачи видео на YouTube, если вы используете RTMPS. Вы должны транслировать видео на этот URL-адрес. В зависимости от того, какое приложение или инструмент вы используете для кодирования видеопотока, вам может потребоваться ввести URL-адрес потока и имя потока по отдельности или объединить их в следующем формате: STREAM_URL/STREAM_NAME |
cdn.ingestionInfo. rtmpsBackupIngestionAddress | stringРезервный URL-адрес для загрузки, который следует использовать для потоковой передачи видео на YouTube, если вы используете RTMPS. |
cdn. resolution | stringРазрешение входящих видеоданных. Допустимые значения для этого свойства:
|
cdn. frameRate | stringЧастота кадров входящих видеоданных. Допустимые значения для этого свойства:
|
status | objectОбъект status содержит информацию о статусе прямой трансляции. |
status. streamStatus | stringСтатус потока. Допустимые значения для этого свойства:
|
status. healthStatus | objectЭтот объект содержит информацию о состоянии работоспособности прямой трансляции, которую можно использовать для выявления, диагностики и устранения проблем с трансляцией. |
status.healthStatus. status | stringКод статуса этого потока. Допустимые значения для этого свойства:
|
status.healthStatus. lastUpdateTimeSeconds | unsigned longПоследнее время обновления состояния работоспособности потока. Значение отражает временную метку UNIX в секундах. |
status.healthStatus. configurationIssues[] | listЭтот объект содержит список проблем конфигурации, влияющих на поток. |
status.healthStatus.configurationIssues[]. type | stringОпределяет тип ошибки, влияющей на поток. |
status.healthStatus.configurationIssues[]. severity | stringУказывает, насколько серьезна проблема для потока. Допустимые значения для этого свойства:
|
status.healthStatus.configurationIssues[]. reason | stringКраткое описание проблемы. В документе «Проблемы конфигурации ресурсов LiveStream» указаны причины, связанные с каждым типом проблемы конфигурации. |
status.healthStatus.configurationIssues[]. description | stringПодробное описание проблемы. По возможности описание содержит информацию о том, как решить проблему. В документе Configuration Issues for LiveStream Resources перечислены все типы проблем конфигурации и их описания. |
contentDetails | objectОбъект content_details содержит информацию о потоке, включая URL-адрес для загрузки субтитров. |
contentDetails. closedCaptionsIngestionUrl | stringURL-адрес приема, куда отправляются субтитры этого потока. |
contentDetails. isReusable | booleanУказывает, является ли поток повторно используемым, что означает, что он может быть привязан к нескольким трансляциям. Обычно вещатели повторно используют один и тот же поток для многих различных трансляций, если эти трансляции происходят в разное время. Если вы установите это значение на false , то поток не будет повторно используемым, что означает, что он может быть привязан только к одной трансляции. Неповторно используемые потоки отличаются от повторно используемых потоков следующим образом:
|