> For the complete documentation index, see [llms.txt](https://docs.videsk.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.videsk.io/es-developers/sdks/intercambio-archivos.md).

# Intercambio archivos

Te explicamos cómo usar nuestro SDK de intercambio de 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`](https://docs.videsk.io/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="https://docs.videsk.io/es-developers/sdks/intercambio-archivos/metodos.md">Métodos</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="https://docs.videsk.io/es-developers/sdks/intercambio-archivos/eventos.md">Eventos</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="https://docs.videsk.io/es-developers/sdks/intercambio-archivos/propiedades.md">Propiedades</a></td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
