Compartilhar via

Carregamento de mídia em Extensão de Cartão Adaptativo

  • Artigo

Observação

O recurso de carregamento de mídia na Extensão de Cartão Adaptável está disponível no SPFx v1.15.2.

Para obter mais informações sobre como instalar o SPFx v1.15.2, consulte Estrutura do SharePoint notas de versão v1.15.2.

Este tutorial também pressupõe que você já criou uma Extensão de Cartão Adaptável do SharePoint.

Para saber como criar sua primeira Extensão de Cartão Adaptável do SharePoint, experimente este tutorial.

Tipo de ação para carregamento de mídia

Selecionar Mídia

Permite que os usuários carreguem conteúdo de mídia por meio de uma ACE (Extensão de Cartão Adaptável). A limitação de tamanho atual é de 1 MB por imagem. Um usuário pode especificar qualquer tipo de imagem a ser carregada. Observação: se um tipo de imagem não for especificado, um erro indicando que somente imagens podem ser carregadas será exibido.

A ação ACE para Selecionar Mídia é: VivaAction.SelectMedia.

Os parâmetros necessários são os seguintes:

  • mediaType: atualmente definido como imagem por padrão. A opção de áudio terá suporte no futuro.
  • allowMultipleCapture [OPCIONAL]: permite que vários arquivos sejam adicionados ao mesmo tempo.
    • Isso está habilitado por padrão.
  • maxSizePerFile [OPCIONAL]: A limitação para que o tamanho do arquivo seja carregado, a limitação sugerida é de 1 MB.
  • supportedFileFormats [OPCIONAL]: Formato delimitado por espaço em tipos permitidos. Se nenhum for fornecido, os arquivos de imagem padrão serão usados para verificação de tipo.
    • Qualquer arquivo que tente ser carregado que não corresponda ao tipo permitido resulta em uma mensagem de erro informando: Este não é um tipo de arquivo que oferecemos suporte. Você só pode carregar imagens.
{
    /**
     * Specify the specific media type that should be selected
     */
    mediaType: MediaType;
    /**
     * Allow multiple images to be selected.
     */
    allowMultipleCapture?: boolean;
    /**
     * Max file size that can be uploaded.
     */
    maxSizePerFile?: number;
    /**
     * File formats supported for upload.
     */
    supportedFileFormats?: string[];
}

Tutorial e exemplos

Você pode dar uma olhada neste tutorial que percorre um guia passo a passo sobre como criar um cartão com a ação de carregamento de mídia disponível.

  1. Carregar uma imagem

    No arquivo json do modelo, adicione a seguinte ação:

    "actions": [
    {
        "type": "VivaAction.SelectMedia",
        "id": "Select Media",
        "title": "Upload Image",
        "parameters": {
          "mediaType": MediaType.Image
        }
    }
]

  2. Carregar várias imagens

    No arquivo json do modelo, adicione a seguinte ação:

    "actions": [
    {
        "type": "VivaAction.SelectMedia",
        "id": "Select Media",
        "title": "Upload Image",
        "parameters": {
              "mediaType": MediaType.Image,
              "allowMultipleCapture": true
        }
    }
]

  3. Carregar apenas imagens JPG

    No arquivo json do modelo, adicione a seguinte ação:

    "actions": [
    {
        "type": "VivaAction.SelectMedia",
        "id": "Select Media",
        "title": "Upload Image",
        "parameters": {
            "mediaType": MediaType.Image,
            "supportedFileFormats": "jpg"
        }
    }
]

  4. Carregar permite que apenas imagens pequenas sejam carregadas

    No arquivo json do modelo, adicione a seguinte ação:

    "actions": [
    {
        "type": "VivaAction.SelectMedia",
        "id": "Select Media",
        "title": "Upload Image",
        "parameters": {
            "mediaType": MediaType.Image,
            "supportedFilemaxSizePerFileFormats": 1000
        }
    }
]

Ação de upload de mídia de acesso por meio do painel de propriedades do cartão de designer de cartão

Se você não quiser escrever um novo ACE, mas ainda quiser ver a mídia carregar em ação, explore este tutorial que permite explorar isso por meio do painel de propriedades.

Observação

A ação de carregamento de mídia pode ser adicionada no modo de exibição do cartão, botões do modo de exibição do cartão ou dentro da própria exibição rápida.

Disponibilidade da ação de upload de mídia

Observação

Atualmente, esse recurso não tem suporte no teams mobile e gerará um erro indicando que isso.

Action Área de Trabalho de Conexão do Viva Viva Connections Mobile Navegador
Selecionar Mídia Com suporte Não suportado Com suporte