Контрольный список интегратора
Контрольный список интегратора
Требования к интеграции C2C
Данный контрольный список содержит рекомендации и требования для подключения к экосистеме C2C. Не каждый пункт применим ко всем устройствам или приложениям C2C. Команда C2C Partnerships совместно с вами определит конкретные требования в рамках программы сертификации C2C.
Базовые требования к интеграции
Все интеграции должны включать:
Обеспечьте гибкие параметры добавления:
-
Переключение между добавлением автоматически/вручную
-
Выбор отдельных или всех файлов
-
Приоритизация типов файлов (необязательно)
-
Приоритизация очереди (необязательно)
-
Параллельные операции добавления (необязательно)
-
Разрешение отмены отдельных или всех операций добавления
-
Потоки тайм-кодов для видео/аудио
-
Поддержка добавления в нескольких форматах (Proxy, OCF, LUT, WAV, RAW, JPG, HEIF, TIFF)
-
Обработка изменений названий проектов (используйте
project_idвместо строк названий)
Четкие индикаторы для следующих сведений:
-
Количество оставшихся файлов
-
Общий размер оставшихся файлов
-
Ход добавления текущего файла
-
Статус завершенных, поставленных в очередь и неуспешных операций добавления
Отображение состояния подключения к сети и автоматическое обновление токена доступа через 8 часов без взаимодействия с пользователем или уведомлений (если нет ошибки обновления)
Дополнительные требования:
- Возможность отмены процесса авторизации на каждом этапе
- Статус сокета для связи в реальном времени
- Заголовок версии микропрограммы во всех вызовах конечных точек HTTPS
Требования к безопасности
Frame.io уделяет первостепенное внимание безопасности. Наши требования:
-
Только 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 — это экосистема, а не просто функция. Требования для конкретных устройств/приложений включают:
-
Автоматическое включение записи с камеры
-
Гибкие параметры камеры
-
Коррекция смещения тайм-кода
-
Возможность записи вручную
-
Последовательная обработка имен файлов
-
Точная синхронизация тайм-кодов
-
Сопоставление имени файла/тайм-кода/метаданных с основным файлом/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, полученный в процессе аутентификации и авторизации. Этот контрольный список основан на руководстве по базовому добавлению и руководстве по расширенному добавлению.