For AI agents: a documentation index is available at the root level at /llms.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Данный контрольный список содержит рекомендации и требования для подключения к экосистеме C2C. Не каждый пункт применим ко всем устройствам или приложениям C2C. Команда C2C Partnerships совместно с вами определит конкретные требования в рамках программы сертификации C2C.
Базовые требования к интеграции
Все интеграции должны включать:
Параметры добавления
Обеспечьте гибкие параметры добавления:
Переключение между добавлением автоматически/вручную
Выбор отдельных или всех файлов
Приоритизация типов файлов (необязательно)
Приоритизация очереди (необязательно)
Параллельные операции добавления (необязательно)
Разрешение отмены отдельных или всех операций добавления
Общие требования
Потоки тайм-кодов для видео/аудио
Поддержка добавления в нескольких форматах (Proxy, OCF, LUT, WAV, RAW, JPG, HEIF, TIFF)
Обработка изменений названий проектов (используйте project_id вместо строк названий)
Статус добавления
Четкие индикаторы для следующих сведений:
Количество оставшихся файлов
Общий размер оставшихся файлов
Ход добавления текущего файла
Статус завершенных, поставленных в очередь и неуспешных операций добавления
Состояние сети
Отображение состояния подключения к сети и автоматическое обновление токена доступа через 8 часов без взаимодействия с пользователем или уведомлений (если нет ошибки обновления)
Дополнительные требования:
Возможность отмены процесса авторизации на каждом этапе
Статус сокета для связи в реальном времени
Заголовок версии микропрограммы во всех вызовах конечных точек HTTPS
Требования к безопасности
Frame.io уделяет первостепенное внимание безопасности. Наши требования:
HTTPS и прямое подключение
Только HTTPS-запросы (HTTP-запросы отклоняются)
Прямое подключение устройства/приложения с Frame.io (без промежуточных сервисов)
Защита учетных данных
Защищенные client_secret и client_id (недоступны пользователю) * Защищенные учетные данные access_token и refresh_token
Зашифрованное хранение секретов и токенов (необязательно, но рекомендуется)
Требования к инструменту добавления
Надежное добавление медиафайлов имеет критически важное значение, особенно в сложных условиях. Интеграции должны:
Функции добавления
Поддерживать операции автоматического добавления либо в реальном времени во время записи (предпочтительно), либо после завершения файла
Показывать четкий статус добавления, включая очередь и результаты
Записывать файлы в локальное хранилище, доступное пользователю
Управление очередью
Поддерживать надежную очередь добавления, которая обрабатывает:
Одновременные операции добавления
Прерывания сети
Циклы питания
Обработка ошибок
Реализовывать автоматический повтор в следующих случаях:
Возобновлять операции добавления с последнего успешного фрагмента
Учитывать состояние ПРИОСТАНОВЛЕНО
Обрабатывать некритичные ошибки AWS
Управлять поврежденными медиафайлами без блокировки других операций добавления
Параметры добавления
Обеспечьте гибкие параметры добавления:
Переключение между добавлением автоматически/вручную
Выбор отдельных или всех файлов
Приоритизация типов файлов (необязательно)
Приоритизация очереди (необязательно)
Параллельные операции добавления (необязательно)
Разрешение отмены отдельных или всех операций добавления
Требования к сети
Интеграции должны:
Скорость и безопасность
Иметь минимальную скорость добавления 50 Мбит/с (при благоприятных условиях сети)
Поддерживать протоколы безопасности WiFi WPA2 (Ethernet не обязателен, но рекомендуется)
Управление сетью
Обрабатывать DHCP и статический IP
Четко отображать статус сети (тип подключения, скорость, состояние)
Переключать сети без повторного сопряжения проекта
Сохранять известные сети WiFi
Требования к тестированию
Технология C2C разработана для сложных условий и требует тщательного тестирования в следующих областях:
Конфигурации сети
Протестируйте все применимые типы подключения:
Стандартный маршрутизатор массового производства с:
проводным WAN
встроенным сотовым модемом
стандартным сотовым модемом массового производства
модемом типа точки доступа
Конфигурации с mesh-маршрутизаторами (включая протокол 802.11r FT)
Прямые подключения к различным типам модемов
Тестирование отказоустойчивости
Неожиданные отключения питания
Отключения сети
Проблемы с провайдером
Обработка поврежденных медиафайлов
Создание офлайн-ресурсов и переподключение
Требования к рабочему процессу
C2C — это экосистема, а не просто функция. Требования для конкретных устройств/приложений включают:
Запись SDI/HDMI
Автоматическое включение записи с камеры
Гибкие параметры камеры
Коррекция смещения тайм-кода
Возможность записи вручную
Последовательная обработка имен файлов
Точная синхронизация тайм-кодов
Прокси-файлы
Сопоставление имени файла/тайм-кода/метаданных с основным файлом/OCF
Оптимизация для LTE (битрейт 1–12 Мбит/с)
Поддержка стандартных кодеков для видео и аудио
Общие требования
Потоки тайм-кодов для видео/аудио
Поддержка добавления в нескольких форматах (Proxy, OCF, LUT, WAV, RAW, JPG, HEIF, TIFF)
Обработка изменений названий проектов (используйте project_id вместо строк названий)
Обеспечение качества
В Frame.io качество имеет важнейшее значение. Ключевые области тестирования включают:
Базовая функциональность
Стабильный запуск и работа
Подключение к проекту
Генерация аппаратного кода
Возможность входа/выхода
Отображение информации о проекте/пользователе
Управление устройствами
Добавление ресурсов
Поддержка форматов
Технические требования
Возобновление добавления после прерываний
Отображение хода работы
Индикация состояния сети
Сохранение подключения на протяжении 8 часов
Возможность отмены авторизации
Прямое подключение к Frame.io
Безопасность учетных данных
Оптимизация скорости сети
Будущие улучшения
API-интерфейс Frame.io «С камеры в облако» постоянно развивается. Поддерживая обратную совместимость, мы приветствуем обсуждение дальнейшего развития, чтобы наш API-интерфейс соответствовал реальным сценариям использования.
Вот и все!
Поздравляем, вы закончили курс UC2CIG (University of C2C Integration Guides)! Надеемся, что это руководство оказалось полезным.
Расскажите нам, если какая-то информация была неясна или отсутствовала, или задайте любые вопросы, касающиеся C2C. Мы будем рады помочь!