Skip to main content

Referência da API HappyOyster-Acting-Enter Travel

O cliente usa o ticket para criar uma Travel real e obter a configuração de entrada RTC, a versão de capacidade do Acting e a proporção de aspecto do player. Uma chamada bem-sucedida cria a Travel.

Escopo

O cliente usa o ticket para criar uma Travel real e obter a configuração de entrada RTC, a versão de capacidade do Acting e a proporção de aspecto do player. Antes de chamar, confirme o seguinte:
  • Autenticação: A API Key primária não é obrigatória; o ticket completa a validação de entrada na sala. Para saber como obtê-lo, veja Obter credenciais de autenticação.
  • Pré-requisitos: O ticket é obtido em Obter Credencial da Travel, não está expirado nem foi usado, e o status do seu Mundo é ready.
  • Chamador: Chamado pelo seu cliente.

Solicitação HTTP

  • Singapore
  • EUA (Virgínia)
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-acting/openapi/v1/travels/enter-travelSubstitua {WorkspaceId} pelo seu ID do Workspace real.

Parâmetros da solicitação

  • Entrar na travel (cliente)
curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-acting/openapi/v1/travels/enter-travel' \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
    -H 'Content-Type: application/json' \
    -d '{
    "ticket": "{ticket}"
}'
Content-Typestring(Obrigatório)Tipo de conteúdo da solicitação. Este parâmetro deve ser definido como application/json.
Authorization string (Obrigatório)Autenticação por Chave de API. A Chave de API primária não é obrigatória; tanto a chave primária quanto uma temporária podem chamá-lo.
  • API Key Primária: começa com sk-, ex. sk-xxx.
  • Chave de API Temporária: começa com st-, por exemplo, st-xxx.
Corpo da solicitação
ticket string (Obrigatório)Uma credencial de uso único, não expirada e não utilizada, obtida em Obter Credencial da Travel. Reutilizar o mesmo ticket retorna 401011.
O Acting não consome maxExperienceTimeSec; não o passe. Se um nível inválido ainda for passado, 400000 será retornado antes do roteamento do modelo.

Parâmetros de resposta

  • Entrada bem-sucedida
{
    "code": 0,
    "message": null,
    "data": {
        "encryptedTravelId": "trvl_a1b2****",
        "encryptedWorldId": "enc_a1b2****",
        "mode": 3,
        "creationModel": "simple",
        "playUrl": null,
        "firstFrame": "https://cdn.happyoyster.com/frames/acting_world_xyz789.jpg",
        "rtcConfig": {
            "channelId": "stream_abc123",
            "appId": "18bca2e3218c46aebf8ff3a32fb12311",
            "token": "007eJxTYOh...",
            "userId": "user_1"
        },
        "version": "actingV2",
        "aspectRatio": "9:16",
        "noStreamAutoEndTimeoutSec": 30,
        "maxExperienceTimeSec": null
    }
}
code integerCódigo de retorno. 0 indica sucesso; diferente de zero é um código de erro.
message stringMensagem de erro. null em caso de sucesso.
data objectDados da resposta. null em caso de falha.

Propriedades

encryptedTravelId stringO ID criptografado da Travel recém-criada. Usado para consultas subsequentes de Status da Travel, pausa, retomada, término e artefatos.encryptedWorldId stringO ID criptografado do Mundo ao qual esta Travel corresponde.mode integerSempre 3 para Acting.creationModel stringSempre simple para Acting.playUrl nullAinda não disponível; fixado em null.firstFrame stringURL do primeiro quadro do Mundo.rtcConfig objectConfiguração de entrada RTC; null quando não há canal de streaming disponível, caso em que o cliente não pode iniciar a reprodução com base nela.
  • channelId: ID do canal RTC
  • appId: ID do aplicativo RTC atribuído pela plataforma
  • token: Token de entrada RTC
  • userId: ID de usuário de entrada RTC, fixado em user_1
version stringA versão de entrada na sala do Acting, fixada em actingV2. As interfaces de controle devem ser chamadas de acordo com esta versão.aspectRatio stringProporção de aspecto. O cliente deve definir a orientação do player adequadamente antes de puxar o fluxo:
  • 9:16 (retrato)
  • 16:9 (paisagem)
noStreamAutoEndTimeoutSec integerTempo limite de término automático sem fluxo em segundos, padrão de 30; a resposta real prevalece. Se rtcStatus não entrar no estado de streaming dentro deste tempo após entrar na sala, chame Encerrar Travel com failCode=TRAVEL_NO_STREAM_AUTO_END.maxExperienceTimeSec nullO Acting não usa a duração máxima da experiência; fixado em null.

Estados pré-requisitos e notas de chamada

  • O Mundo correspondente ao ticket deve estar ready, e o ticket não deve estar expirado nem usado.
  • Uma chamada bem-sucedida cria a Travel; reutilizar o mesmo ticket retorna 401011.
  • Quando o recurso ou especificação do Acting não está habilitado, 403007 é retornado e nenhuma Travel é criada.
  • version deve ser tratado como actingV2; não chame interfaces de controle de acordo com outra versão de capacidade.
  • O cliente deve ler aspectRatio antes de estabelecer o pull do fluxo ou o contêiner de renderização: use um contêiner retrato para 9:16 e um contêiner paisagem para 16:9.
  • Não passe maxExperienceTimeSec. O Acting não encerra automaticamente por este campo, e o cliente não deve usá-lo para implementar uma contagem regressiva.
  • rtcConfig=null significa que não há atualmente nenhum canal de streaming disponível, e o cliente não pode iniciar a reprodução com base nele.

Códigos de erro

Se a chamada do modelo falhar e retornar um erro, consulte Códigos de Erro do HappyOyster para resolvê-lo.

Próximos passos

Após entrar na sala com sucesso: