Todos os produtos
Search
Central de documentação

ApsaraVideo VOD:Perguntas frequentes sobre upload de ativos de mídia

Última atualização: Jun 27, 2026

Este tópico descreve problemas comuns relacionados ao upload de ativos de mídia e suas respectivas soluções.

Arquivo travado no estado de uploading

Esse comportamento pode ter uma das seguintes causas:

  • Causa 1: O upload baseado em URL é um processo assíncrono e não garante conclusão imediata.

    O método de upload baseado em URL é assíncrono e não assegura que a transferência termine rapidamente. Os uploads podem levar várias horas ou até dias para serem concluídos. Esse recurso está disponível apenas nas regiões China (Shanghai), China (Beijing), China (Shenzhen), Singapore e US (Silicon Valley). Recomendamos integrar o SDK de upload do lado do servidor do ApsaraVideo VOD para realizar seus uploads.

  • Causa 2: Apenas foi gerada uma credencial de upload, sem que o arquivo fosse efetivamente enviado.

    Chamar a API CreateUploadVideo obtém somente uma credencial de upload e cria informações básicas do ativo de mídia, mas não transfere o arquivo em si. É necessário chamar operações do OSS para concluir o envio do arquivo. Para obter o procedimento completo, consulte Fazer upload de arquivos de mídia chamando a API do ApsaraVideo VOD.

  • Causa 3: O upload está lento devido ao tamanho elevado do arquivo.

    Verifique se o tempo de upload é compatível com o tamanho do arquivo. Por padrão, métodos como o uso do console, SDKs de upload e ferramentas de cliente utilizam upload multipart, que aceita arquivos individuais de até 48,8 TB. O SDK de upload também oferece um recurso de upload simples, com suporte a arquivos individuais de até 5 GB.

  • Causa 4: Problemas de rede.

    Verifique se a largura de banda da sua rede atende aos requisitos necessários.

Falha no upload via SDK para iOS com erro NSCocoaErrorDomain

Esse erro, identificado pelo código 207 e pela mensagem 'Error Domain=NSCocoaErrorDomain', geralmente indica uma falha na leitura do arquivo causada por permissões insuficientes. Resolva esse problema de uma das seguintes formas:

  • Solução 1: Conceda ao SDK de upload para iOS permissão para ler recursos locais.

  • Solução 2: Mova os recursos locais para o diretório sandbox antes de iniciar o upload.

Upload baseado em URL: erro "not open in current region"

A mensagem de erro The service is not open in current region indica que o upload baseado em URL não tem suporte na região atual. Esse recurso está disponível em um número limitado de regiões, incluindo China (Shanghai) e Singapore.

Caso esteja em uma região sem suporte, baixe os arquivos localmente e faça o upload utilizando um SDK de upload. Para mais informações, consulte Visão geral do SDK de upload.

Imagens enviadas não aparecem no console

Imagens enviadas com o tipo definido como cover são tratadas como capas de vídeo e não são exibidas no console do ApsaraVideo VOD. Elas só podem ser recuperadas por meio de chamada de API. Para mais detalhes, consulte CreateUploadImage.

Problema de compatibilidade no upload via SDK JavaScript no WeChat

Esse problema decorre de uma incompatibilidade com a implementação HTML5 no navegador do WeChat. Para corrigir, remova o parâmetro multiple="" da tag <input type="file" name="file" id="files" multiple="">.

Pré-visualização distorcida com o SDK de ingestão de stream

Ao selecionar 480p como resolução do stream no SDK de ingestão, a página de pré-visualização pode aparecer esticada, embora a saída real do stream permaneça normal. Isso ocorre porque 480p corresponde a uma resolução de 480×640 pixels. Como essa proporção não é compatível com a maioria das telas de celulares, a pré-visualização fica distorcida.

Solução: Modifique a proporção do SurfaceView na página de pré-visualização. Atualize seu arquivo activity_push.xml conforme mostrado abaixo.

public void initView() {
    mPreviewView = (SurfaceView) findViewById(R.id.preview_view);
    mPreviewView.getHolder().addCallback(mCallback);
}
<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent">
    <SurfaceView
            android:id="@+id/preview_view"
            android:layout_width="match_parent"
            android:layout_height="match_parent"/>

    <!--FrameLayout-->
        <!--android:id="@+id/publisher_fragment"-->
        <!--android:layout_width="match_parent"-->
        <!--android:layout_height="match_parent"-->
        <!--android:visibility="gone"/>-->

    <android.support.v4.view.ViewPager
            android:id="@+id/tv_pager"
            android:layout_width="match_parent"
            android:layout_height="match_parent"
            >
    </android.support.v4.view.ViewPager>
</RelativeLayout>

Visualizar e importar pacotes AAR no Android Studio

Para inspecionar o conteúdo de um pacote AAR, altere a extensão do arquivo de .aar para .zip e descompacte-o. Em seguida, visualize os componentes internos, como arquivos .class, arquivos .xml, arquivos .jar, imagens e arquivos de texto.

Para importar um pacote AAR:

  1. Copie o arquivo .aar para o diretório do projeto, geralmente localizado em projectName/libs/, e recarregue o projeto. Copie arquivos de biblioteca como AlivcPlayer.aar, aliyun-vod-upload-android-sdk-1.1.1.jar, aliyun-vod-croe-android-sdk-1.2.1.jar, gson-2.8.0.jar e jsr305-3.0.0.jar para o diretório app > libs do seu projeto. Após copiar os arquivos, recarregue o projeto.

  2. No arquivo build.gradle, adicione o caminho do repositório local sob a tag raiz e inclua as dependências de compilação.

    O valor de dirs deve corresponder ao diretório onde o pacote foi colocado. Para a dependência compile, defina name como o nome do arquivo AAR (sem a extensão) e ext como 'aar'.

    repositories{
        flatDir{
            dirs 'libs'
        }
    }
    
    dependencies {
        compile fileTree(include: ['*.jar'], dir: 'libs')
        testCompile 'junit:junit:4.12'
        compile 'com.android.support:appcompat-v7:26+'
        compile 'com.android.support:design:26+'
        compile (name:'AlivcPlayer',ext:'aar')
        // The upload SDK depends on the OSS upload SDK.
        compile 'com.aliyun.dpa:oss-android-sdk:2.4.5'
    }
  3. Selecione Build > Rebuild para recompilar o projeto.

    Após a conclusão da compilação, o pacote AAR importado aparecerá na seção External Libraries do seu projeto.

    External Libraries
    ├── Android API 26 Platform
    ├── JRE 1.8
    ├── AlivcPlayer:@aar
    │   ├── classes.jar (library root)
    │   │   └── com
    │   │       ├── alivc.player
    │   │       └── aliyun.aliyunplayer
    │   └── res (library root)
    │       ├── values
    │       └── values-zh-rCN
    ├── com.aliyun.dpa:oss-android-sdk-2.4.5
    ├── com.android.support:animated-vector-drawable:26.0.0-alpha1
    ├── com.android.support:appcompat-v7:26.0.0-alpha1
    ├── com.android.support:design:26.0.0-alpha1
    ├── com.android.support:recyclerview-v7:26.0.0-alpha1
    ├── com.android.support:support-annotations:26.0.0-alpha1
    └── com.android.support:support-compat:26.0.0-alpha1

Links relacionados

Para procedimentos detalhados de upload, consulte os seguintes tópicos: