Invocar um cliente desktop - Drive and Photo Service: Central de Documentação do Alibaba Cloud

Nota

Este tópico descreve como usar um esquema de URL para invocar um cliente desktop e executar operações específicas.

1 Esquema de URL

O nome do protocolo do esquema de URL do cliente desktop BasicUI é pds seguido pelo ID do domínio.

Por exemplo, se o ID do domínio for hz65, o nome do protocolo do esquema de URL será pdshz65:.

Exemplo de abertura de uma URL:

window.open("pdshz65:open?opt=%7B%22seq_id%22%3A%22x3hug4qu1xn%22%2C%22pathname%22%3A%22%2Findex%22%7D")

2 Parâmetros de URL

<protocol>:<action>?opt=[opt]

Parâmetro	Descrição
protocol	Nome do protocolo. O valor é pds seguido pelo ID do domínio.
action	Caminho da URL. O valor deve ser um verbo. Valores válidos: `open` e `download`.
opt	String gerada após codificar a string JSON especificada com a função `encodeURIComponent(JSON.stringify(opt))`.

2,1 Abrir uma URL específica

Campos do parâmetro opt:

Campo	Descrição
seq_id	ID de sequência. Deve ser único na sessão. A sessão abrange o período entre a abertura e o fechamento do cliente desktop.
pathname	Caminho da URL de redirecionamento após a ativação do cliente.

Exemplo:

let domainId='hz65'
let action='open'
let opt ={
  "seq_id": Math.random().toString(36).substring(2),
  "pathname":"/drive"
}
let url = `pds${domainId}:${action}?opt=${encodeURIComponent(JSON.stringify(opt))}`
window.open(url)

2,2 Baixar um arquivo específico

Campos do parâmetro opt:

Campo	Descrição
seq_id	ID de sequência. Deve ser único na sessão. A sessão abrange o período entre a abertura e o fechamento do cliente desktop.
pathname	O `pathname` da URL de redirecionamento após a ativação do cliente.
loc_type	Tipo de local de armazenamento. Valores válidos: `drive` e `share`.
loc_id	ID do local de armazenamento. Se o campo `loc_type` for `drive`, este campo terá o valor de `drive_id`. Se o campo loc_type for `share`, o valor será `share_id`.
file_keys	Arquivo para download. No modo de armazenamento padrão, use um array de `file_id`. No modo de hospedagem, use um array de `file_path`. Exemplo: `["file_id1","file_id2"]`.

Exemplo:

let domainId='hz65'
let action='download'
let opt ={
  "seq_id": Math.random().toString(36).substring(2),
  "loc_type": "drive",
  "loc_id": "1",
  "pathname":"/drive/folders/5e9d2e02570e5a973cd64b648cbf97ac2ebb26dc",
  "file_keys":["5faebd028e8365fef08b4a019308765631e179e0"]
}
let url = `pds${domainId}:${action}?opt=${encodeURIComponent(JSON.stringify(opt))}`
window.open(url)