Panoramica

Questa esercitazione spiega come caricare le risorse in Frame.io. Frame.io gestisce tutti i tipi di file, non solo video, ma anche script, immagini, mappe e file di riferimento. In termini più tecnici, una risorsa in Frame.io è una rappresentazione completa di un file in S3 e del relativo contesto in Frame.io, inclusi transcodifiche, contesto di utente/team/progetto e metadati. Per ulteriori informazioni sulle risorse, consulta la rispettiva definizione.​

Gerarchie principali

È utile anche sapere in che modo Frame.io struttura i suoi modelli principali.

Gli account, ai quali appartengono gli utenti, hanno molti progetti che contengono risorse. I team sono disponibili solo per gli account Enterprise e forniscono un livello aggiuntivo di separazione logica. Le risorse non “sanno” a quale team appartengono, ma solo a quale progetto e account. I progetti, però, sono di proprietà esclusiva dei team e non degli account, di conseguenza i team sono parte integrante del processo di caricamento delle risorse.

Prerequisiti

Per questa esercitazione ti serve:

• Un account Frame.io con un token per sviluppatori (i token sono spiegati di seguito)
• SDK Python di Frame.io

Carica una risorsa

Questa sezione illustra i passaggi per caricare una risorsa.

1. Crea un token per sviluppatori in developer.frame.io con i seguenti ambiti:

2. Individua una destinazione per la risorsa. Come minimo, le risorse devono essere inserite all’interno di un progetto. Devi recuperare l’ID della risorsa radice (root_asset_id) per un progetto o l’ID di una risorsa per una cartella per specificare la posizione nella gerarchia dei file in cui vuoi caricare.

In generale, devi recuperare (nell’ordine specificato):

• ID account e scegliere un account
• ID team e scegliere un team
• Progetti associati a un team
• ID del progetto su cui lavorare
• ID della risorsa root o ID di una cartella

Puoi eseguire il caricamento direttamente nella root di un progetto usando il root_asset_id.

Elenca le risorse

Per scegliere dove caricare la nuova risorsa, puoi usare l’API in modo da elencare tutte le risorse in un progetto o in una cartella all’interno di un progetto. Se una risorsa è una cartella, conterrà risorse figlio che possono essere file e cartelle. Quando elenchi le informazioni delle risorse, puoi usare qualsiasi ID risorsa, ma se vuoi rivedere tutto ciò che è associato a un progetto, usa il 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"
)

Dall’elenco restituito delle risorse, puoi usare un ID per qualsiasi risorsa che sia una cartella oppure l’ID della risorsa root. Userai questo ID per contrassegnare dove vuoi caricare la nuova risorsa.

Carica la risorsa

In questo esempio, caricheremo un nuovo file. Devi inviare la richiesta con le seguenti informazioni:

$
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

Crea il tuo programma di caricamento dei file

Se vuoi creare un programma di caricamento personalizzato, si consiglia di caricare i chunk in parallelo per avere delle prestazioni ottimali. Ogni chunk deve essere inserito (PUT) direttamente negli URL di Amazon S3 forniti nella risposta dall’API di Frame.io. I chunk dei file devono corrispondere all’ordine di upload_url forniti, poiché determinano la sequenza della risorsa finale concatenata e transcodificata. Questo significa che il primo URL prende il primo chunk, il secondo URL prende il secondo chunk e così via.

Esempio di pseudocodice

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

Le intestazioni per ogni richiesta a S3 devono includere il filetype della nuova risorsa esattamente come è stato restituito dalla chiamata iniziale all’API Frame.io, oltre a un’intestazione di privacy aggiuntiva:

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

Puoi vedere un esempio di come tutto questo viene gestito nel nostro SDK Python qui.

Ecco fatto! Una volta completate le chiamate PUT agli `upload_url, avrai una nuova risorsa in Frame.io.