Visão geral

Este tutorial aborda como fazer upload de ativos no Frame.io.O Frame.io pode lidar com todos os tipos de arquivo, não apenas vídeos, mas também scripts, imagens, mapas e arquivos de referência.Em termos mais técnicos, um ativo no Frame.io é uma representação robusta de um arquivo no S3 e seu contexto no Frame.io, incluindo transcodificações, contexto de usuário/equipe/projeto e metadados.Para obter mais informações sobre ativos, consulte a definição de recursos.

Hierarquias principais

Também é útil saber como o Frame.io estrutura seus modelos principais.

Contas, às quais Usuários pertencem, têm muitos Projetos, que contêm Ativos.Equipes estão disponíveis apenas para contas corporativas e fornecem um nível adicional de separação lógica.Os ativos não “sabem” a qual equipe pertencem, apenas a qual projeto e conta, mas os projetos são estritamente de propriedade de equipes, não de contas, tornando as equipes parte integral do processo de upload de ativos.

Pré-requisitos

Para este tutorial, você precisará de:

• Uma conta Frame.io com um token de desenvolvedor (tokens são explicados abaixo)
• Frame.io Python SDK

Fazer upload de um ativo

Esta seção orienta você pelas etapas para fazer upload de um ativo.

1. Crie um token de desenvolvedor em developer.frame.io com os seguintes escopos:

2. Localize um destino para o ativo.No mínimo, os ativos precisam ser colocados em um Projeto.Você precisa recuperar o ID do ativo raiz (root_asset_id) de um projeto ou um ID de ativo de uma pasta para especificar a localização na hierarquia de arquivos para a qual deseja fazer upload.

Em geral, você precisa recuperar (na ordem especificada):

• ID(s) de conta e escolher uma conta
• ID(s) de equipe e escolher uma equipe
• projetos associados a uma equipe
• o ID do projeto para o projeto com o qual você quer trabalhar
• o ID do ativo raiz ou um ID de pasta

Você pode fazer upload diretamente na raiz de um projeto usando o root_asset_id.

Listar ativos

Para escolher onde você quer fazer upload do novo ativo, você pode usar a API para listar todos os ativos em um projeto ou pasta dentro de um projeto.Se um ativo é uma pasta, ele contém ativos filhos, que também podem ser arquivos e pastas.Ao listar informações de ativos, você pode usar qualquer ID de ativo, mas se quiser revisar tudo associado a um projeto, use o root_asset_id.

python-sdk from frameioclient import FrameioClient import os

ASSET_ID = "" TOKEN = ""

client = FrameioClient(TOKEN) response_list = client.assets.get_children(ASSET_ID) assets = response_list.results

for item in assets: print(item[‘id’], item[‘name’])

# Code sample uses the Python SDK: https://github.com/Frameio/python-frameio-client
from frameioclient import FrameioClient
client = frameioclient("FRAMEIO_TOKEN)
asset = client.assets.upload(
  destination_id="PARENT_ASSET_ID",
  filepath="./my_file.mov"
)
# Create a folder:
asset = client.assets.create_folder(
  parent_asset_id=PARENT_ASSET_ID,
  name="My Awesome Folder"
)

Na lista de ativos retornada, você pode usar um ID para qualquer ativo que seja uma pasta, ou o ID do ativo raiz.Você vai usar este ID para marcar onde quer fazer upload do novo ativo.

Fazer upload de ativo

Neste exemplo, vamos fazer upload de um novo arquivo.Você envia a solicitação com as seguintes informações:

$
curl --request POST \
>
$
--url https://api.frame.io/v2/assets/<asset_id>/children \ --header 'authorization: Bearer<dev_token>' \
>
$
--header 'content-type: application/json' \
>
$
$
  
$
$
--data '{"filesize":200000,"filetype":"video/mp4","name":"test","source":{"url":"URL_FOR_VIDEO"},"type":"file"}'

1
filesize = 30000000
2
upload_urls = ["https://...", "https://...", "https://..."]
3
chunk_size = filesize / len(upload_urls)
4
5
start_byte = 0 # Set to 0 to start
6
for i, url in enumerate(upload_urls):
7
  end_byte = chunk_size * (i + 1)
8
  upload_chunk(url=url, start_byte, end_byte)
9
  start_byte = start_byte + chunk_size

Criar seu próprio carregador de arquivos

Se quiser criar seu próprio carregador, para melhor desempenho, recomenda-se fazer upload de blocos em paralelo.Cada bloco deve ser PUT diretamente para os URLs do Amazon S3 fornecidos na resposta da API do Frame.io.Os blocos de arquivo devem corresponder à ordem dos upload_urls fornecidos, pois eles determinam a sequência do ativo final concatenado e transcodificado. Isso significa que o 1º URL recebe o 1º bloco, o 2º URL recebe o 2º bloco, e assim por diante.

Exemplo de pseudocódigo

1
filesize = 30000000
2
3
4
5
6
upload_urls = ["https://...", "https://...", "https://..."]
7
8
9
10
11
chunk_size = filesize / len(upload_urls)
12
13
14
15
16
17
start_byte = 0 # Set to 0 to start
18
19
20
21
22
for i, url in enumerate(upload_urls):
23
24
25
  
26
27
end_byte = chunk_size * (i + 1)
28
29
30
  
31
32
upload_chunk(url=url, start_byte, end_byte)
33
34
35
  
36
37
start_byte = start_byte + chunk_size

Os cabeçalhos para cada solicitação ao S3 devem incluir o filetype do novo ativo exatamente como foi retornado da chamada inicial para a API do Frame.io, bem como um cabeçalho de privacidade adicional:

PUT https://frameio-uploads-production.s3/etc/etc
Content-Type: video/mp4
x-amz-acl: private

Você pode ver um exemplo de como isso é tratado em nosso SDK Python aqui.

Pronto!Depois de concluir as chamadas PUT para os upload_urls, você terá um novo ativo no Frame.io.