Todos los productos
Search

Este producto

    Alibaba Cloud Model Studio:Flujo de integración

    Centro de documentos

    Alibaba Cloud Model Studio:Flujo de integración

    Última actualización: Oct 12, 2026

    Su servidor prepara mundos y exporta artefactos a través de las API abiertas de HappyOyster; el SDK del cliente gestiona la conexión RTC y la interacción en tiempo real.

    HappyOyster sigue una arquitectura dividida en servidor + cliente: su servidor gestiona los mundos y los artefactos a través de las API abiertas, y el SDK del cliente proporciona la experiencia en tiempo real. Antes de comenzar, complete Obtener credenciales de autenticación.

    Nota

    • Las API abiertas del lado del servidor se dividen por modo de experiencia en Aventura, Dirección y Actuación. Elija los endpoints que correspondan a su modo.
    • Un Mundo y un Viaje están estrictamente vinculados al modelo que los creó; el acceso entre modelos devuelve 403001 (mundo) o 404000 (viaje).
    • El SDK no es responsable de crear ni gestionar mundos; únicamente proporciona la experiencia en tiempo real del lado del cliente.

    1. Preparar un mundo (API abierta del servidor)

    1. Crear un mundo, utilizando el endpoint correspondiente a su modo: Aventura-Crear mundo / Dirección-Crear mundo / Actuación-Crear mundo.
    2. Consultar el estado de compilación (cada 3–5 segundos) hasta que sea ready: Aventura-Consultar estado de compilación del mundo / Dirección-Consultar estado de compilación del mundo / Actuación-Consultar estado de compilación del mundo.
    3. Canjear por un ticket: Con la clave de API principal, llame a Aventura-Obtener credencial de viaje / Dirección-Obtener credencial de viaje / Actuación-Obtener credencial de viaje para obtener un ticket de un solo uso.
    4. Entregar credenciales al cliente: Envíe el ticket junto con la clave de API temporal (utilizada como token del SDK) al cliente.

    2. Experiencia en tiempo real (SDK del cliente)

    El SDK gestiona la conexión RTC, la reproducción de video y los comandos de interacción.

    1. Inicializar el SDK: initialize + updateToken — inyecte el host de API y la clave de API temporal.

    2. Iniciar la sesión: startTravel(ticket); el SDK ingresa a la sala y establece la conexión automáticamente.

    3. Adjuntar el video: Agregue la vista devuelta por attachVideo() a su diseño. Para el modo Actuación, configure la orientación del contenedor según el valor aspectRatio devuelto al ingresar a la sala.

    4. Interacción en tiempo real:

      • Aventura: Llame a sendCommand para enviar comandos de dirección, cámara o acción.
      • Dirección: Llame a sendInstruct para enviar instrucciones de texto que impulsen la historia.
      • Actuación: Llame a sendInstruct para enviar instrucciones de texto.

    5. Control de sesión:

      • Aventura: No se admiten las funciones de pausa ni rebobinado.
      • Dirección: Admite pause, rewind y resume.
      • Actuación: Admite pause y resume; no se admite rewind.

    6. Finalizar la sesión: endTravel libera RTC y recursos.

    3. Recuperar artefactos (API abierta del servidor)

    Después de que finalice el viaje, consulte con la clave de API principal en Aventura-Consultar artefactos del viaje / Dirección-Consultar artefactos del viaje / Actuación-Consultar artefactos del viaje hasta que composeStatus = ready. Para entrega externa, recomendamos video.withInstructionAndWatermark (compuesto con instrucciones y marca de agua).

    Siguientes pasos

    • Descargar SDK y demos: Paquetes de SDK, guías de integración, referencias de API y demos de código abierto para cada plataforma.