# Intercambio archivos

`BeamPort` te permite intercambiar de archivos de forma sencilla, permitiendo definir tu propia interfaz o flujos.

{% hint style="warning" %}
La documentación y recursos necesarios para utilizar `BeamPort` está estrictamente restringido para uso de clientes de Videsk. Nos reservamos el derecho de restringir su acceso y uso, si detectamos un uso inadecuado.
{% endhint %}

## Instalación

Para utilizar el intercambio de archivo necesitas cargar:

{% tabs %}
{% tab title="ESM" %}

```html
<script type="module">
    import BeamPort from "https://cdn.videsk.io/sdk/beamport.esm.js";
    // ...
</script>
```

{% endtab %}

{% tab title="Dynamic import" %}
**Vue**

```javascript
onMounted(async () => {
  const { default: BeamPort } = await import("https://cdn.videsk.io/sdk/beamport.esm.js");
  // ...
});
```

**React**

```javascript
useEffect(() => {
  import("https://cdn.videsk.io/sdk/beamport.esm.js")
    .then(({ default: BeamPort }) => {
      const beamport = new beamPort();
      // ...
    });
}, []);
```

**Angular**

```javascript
async ngOnInit() {
  const { default: BeamPort } = await import("https://cdn.videsk.io/sdk/beamport.esm.js");
  // ...
}
```

**Svelte**

```javascript
onMount(async () => {
    const { default: BeamPort } = await import("https://cdn.videsk.io/sdk/beamport.esm.js");
    // ...
  });
```

{% endtab %}

{% tab title="HTML" %}

```html
<script src="https://cdn.videsk.io/sdk/beamport.min.js" async></script>
```

{% endtab %}

{% tab title="Javascript" %}

```javascript
const script = document.createElement('script');
script.src = "https://cdn.videsk.io/sdk/beamport.min.js";
script.setAttribute('async', true);
document.appendChild(script);
```

{% endtab %}
{% endtabs %}

## Instanciación

Para comenazar deberás instanciar un nuevo `BeamPort`.

```javascript
const port = new BeamPort();
```

{% hint style="warning" %}
Debes crear solo 1 `BeamPort` por cada llamada, de lo contrario el comportamiento no será el esperado.
{% endhint %}

A continuación, se describe el flujo para la creación de una instancia `BeamPort`, considerando que inicialmente se desencadena desde el lado del agente enviando una solicitud de conexión a través de [`Phone SDK`](/es-developers/sdks/phone.md).

```mermaid
sequenceDiagram
    participant User as BeamPort Customer
    participant Phone as Phone
    participant Agent as BeamPort Agent

    Agent ->> Phone: Send "beamport:create" event
    Phone ->> User: Send accessToken
    User -->> User: Create instance
    User ->> Agent: Establish direct bidirectional connection
```

## Consideraciones

1. Utilizamos como identificación el contenido del archivo calculando un CRC-32, por lo que no se enviarán dos archivos idénticos en bytes.
2. Posee un algorítmo de envío por trozos (chunks) para balanceo de red.
3. Cada envío verifica la integridad del archivo mediante CRC-32 chunking.
4. Se verifica la integridad cada trozo recibido con el par remoto, de lo contrario se reintenta.
5. El límite del tamaño del archivo está dado por la memoria del dispositivo emisor y receptor. Recomendamos enviar archivos no superiores a 2GB.
6. El envío finaliza cuando el cálculo de CRC-32 es equivalente al del par emisor.
7. `BeamPort` realizará reconexiones automáticas cuando existan desconexiones por red.

Para enviar archivos deberás conocer más de los métodos, eventos y propiedades de `BeamPort`:

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Métodos</strong></td><td>Conoce cuáles y cómo usar los métodos de BeamPort.</td><td></td><td><a href="/pages/t5KahKdiQonTwtnOO81A">/pages/t5KahKdiQonTwtnOO81A</a></td></tr><tr><td><strong>Eventos</strong></td><td>Conoce cuáles y cómo usar los eventos de BeamPort.</td><td></td><td><a href="/pages/DaIXSE9flAIml6pKP3mu">/pages/DaIXSE9flAIml6pKP3mu</a></td></tr><tr><td><strong>Propiedades</strong></td><td>Conoce cuáles son las propiedades de un BeamPort.</td><td></td><td><a href="/pages/zS2jadA2CVDrajbQPvHL">/pages/zS2jadA2CVDrajbQPvHL</a></td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.videsk.io/es-developers/sdks/intercambio-archivos.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.