Контрольный список интегратора

Требования к интеграции C2C

Данный контрольный список содержит рекомендации и требования для подключения к экосистеме 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. Мы будем рады помочь!

Если вы еще не сделали этого, просмотрите руководство Реализация C2C: настройка перед продолжением. Вам понадобится access_token, полученный в процессе аутентификации и авторизации. Этот контрольный список основан на руководстве по базовому добавлению и руководстве по расширенному добавлению.