Rede - Mobile Platform as a Service: Central de Documentação do Alibaba Cloud

my.request

Faz uma requisição de rede a partir de um miniapp.

A API my.request suporta atualmente os métodos GET, POST e DELETE.
A API my.request aceita apenas requisições HTTPS no momento.

Nota

Esta API é compatível com as versões 1.11.0 e posteriores da biblioteca base. Use my.canIUse('request') para gerenciar a compatibilidade. Para mais informações, consulte Descrição da Biblioteca Base do Mini Program.
Esta API é suportada no mPaaS 10.1.60 e versões posteriores.
A API my.httpRequest foi descontinuada. Use my.request em seu lugar.
O cabeçalho de requisição padrão para my.request é {'content-type': 'application/json'}, e não {'content-type': 'application/x-www-form-urlencoded'}. As chaves e valores no objeto de cabeçalho da requisição devem ser strings.

Para mais detalhes, consulte Perguntas frequentes sobre my.request.

Observações de uso:

Ative a Permission control switch em Release Mini Program > Open Platform Mini Program Management. Em seguida, configure a lista de permissões de nomes de domínio em Server domain name whitelist. O miniapp só pode se comunicar com domínios presentes nessa lista ao chamar APIs como requisições HTTP (my.request) e uploads de arquivos (my.uploadFile).
Após adicionar um nome de domínio à lista de permissões de domínios do servidor, reempacote, faça upload e gere uma versão de teste para que a alteração tenha efeito.
Ao depurar no IDE, use um dispositivo real para a pré-visualização.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
url	String	Sim	A URL do servidor de destino.
headers	Object	Não	Defina o cabeçalho da requisição HTTP. O valor padrão é `{'content-type': 'application/json'}`. As chaves e valores neste objeto devem ser strings.
method	String	Não	O valor padrão é GET. Os métodos GET, POST e DELETE são suportados.
data	Object / ArrayBuffer	Não	Para mais informações, consulte a descrição do parâmetro data abaixo.
timeout	Number	Não	O tempo limite em milissegundos (ms). O valor padrão é 30000.
dataType	String	Não	O formato de dados esperado da resposta. O valor padrão é json. Os formatos suportados incluem json, text, base64 e arraybuffer.
success	Function	Não	A função de callback para uma chamada bem-sucedida.
fail	Function	Não	A função de callback para uma chamada com falha.
complete	Function	Não	A função de callback executada ao final da chamada, independentemente de sucesso ou falha.

Descrição do parâmetro data

Os dados enviados ao servidor são convertidos em string. Caso os dados não sejam uma string, a conversão segue as regras abaixo:

Se o método for GET, os dados são convertidos em uma query string: encodeURIComponent(k)=encodeURIComponent(v)&encodeURIComponent(k)=encodeURIComponent(v)....
Se o método for POST e headers['content-type'] for application/json, os dados são serializados para JSON.
Se o método for POST e headers['content-type'] for application/x-www-form-urlencoded, os dados são convertidos em uma query string: encodeURIComponent(k)=encodeURIComponent(v)&encodeURIComponent(k)=encodeURIComponent(v)....

Descrição do referer

Não é possível definir o cabeçalho referer de uma requisição de rede.
O formato é fixo: https://urlhost/{appid}/{version}/page-frame.html, onde {appid} é o APPID do miniapp e {version} é o número da versão do miniapp.

Valor de retorno de success

Nome	Tipo	Descrição
data	String	Os dados da resposta. O formato depende do parâmetro `dataType` da requisição.
status	Number	O código da resposta.
headers	Object	O cabeçalho da resposta.

Códigos de erro

Código de erro	Descrição	Soluções
1	Navegação para outra página ocorreu antes da conclusão da requisição.	Aguarde a conclusão da requisição antes de acessar outra página.
2	Erro de parâmetro.	A URL pode estar muito longa. Coloque os parâmetros no campo `data`. Verifique se os dados da requisição são válidos e estão formatados corretamente. Antes de enviar a requisição, imprima os parâmetros de entrada em um log.
11	Sem permissão para requisição cross-domain.	Verifique se o nome de domínio da requisição está na lista de permissões de domínios. Para testar a versão de desenvolvimento, clique em Details no canto superior direito do IDE e selecione Ignore httpRequest domain name validity check. Nota: Ao lançar uma nova versão, adicione o nome de domínio à Server Domain Name Whitelist. Caso contrário, ocorrerão erros.
12	Erro de rede.	Verifique se o ambiente de rede está estável e se o servidor está funcionando corretamente.
13	Tempo limite excedido.	Verifique a estabilidade do ambiente de rede e se o servidor está respondendo adequadamente. Se a requisição demorar muito, defina um período maior para o parâmetro `timeout`.
14	Falha na decodificação.	Verifique se os formatos de dados da requisição e da resposta são consistentes entre frontend e backend. Por exemplo, se o formato dos dados de resposta for `text`, mas o parâmetro de entrada `dataType` for `JSON`, a API retornará um erro. Nesse caso, altere o formato dos dados de resposta do backend para JSON.
15	Falha ao passar parâmetros.	Se usar `urlencode` para passar parâmetros de uma página do miniapp, codifique todo o conjunto de parâmetros.
19	Erro HTTP.	Confirme se a URL da requisição é acessível via protocolo HTTPS pela internet pública. Em um dispositivo real, as requisições do miniapp são requisições de produção e não podem ser enviadas para uma rede local (LAN). Se encontrar erros HTTP como 404, 500 ou 504, abra o depurador do IDE e acesse a aba Network para visualizar informações detalhadas do erro. Em seguida, trate o erro com base no código de erro HTTP. O certificado SSL está incorreto. Substitua o certificado SSL do site.
20	Requisição interrompida ou limitada pelo servidor.	Confirme se o servidor da requisição está acessível e respondendo corretamente.
23	Falha na requisição do agente.	Verifique se a configuração do agente está correta.

Nota

Quando o parâmetro de entrada dataType está definido como json, o framework do miniapp executa primeiro uma operação JSON.parse no resultado. Se a análise falhar, o framework retorna um erro com código 14. Quando o parâmetro de entrada dataType está definido como text e o formato do conteúdo retornado não corresponde, o framework também retorna um erro com código 14. Se encontrar esse erro, verifique primeiro se o dataType está configurado corretamente.

Se uma chamada my.request retornar You are not authorized to call this interface, configure a lista de permissões de nomes de domínio em Open Platform Mini Program Management > Server domain name whitelist.

Exemplo de código

Este exemplo serve apenas como referência. Use seu próprio endereço para testes.

my.request({
  url: 'https://example.org/post',
  method: 'POST',
  data: {
    from: 'Alipay',
    production: 'AlipayJSAPI',
  },
  dataType: 'json',
  success: function(res) {
    my.alert({content: 'success'});
  },
  fail: function(res) {
    my.alert({content: 'fail'});
  },
  complete: function(res) {
    my.hideLoading();
    my.alert({content: 'complete'});
  }
});

// Returns a RequestTask, which lets you call the abort method to cancel the request.
const task = my.request({url: 'https://example.org/post'})
task.abort()

Valor de retorno

RequestTask

Um objeto de tarefa de requisição de rede.

Método

RequestTask.abort()

my.uploadFile

Nota

Esta API é suportada no mPaaS 10.1.32 e versões posteriores.

Faz upload de um recurso local para o servidor do desenvolvedor.

Observações de uso:

Configure a lista de permissões de nomes de domínio em Open Platform Mini Program Management > Server Domain Name Whitelist. O miniapp só pode se comunicar com domínios listados nessa permissão ao invocar APIs como requisições HTTP (my.request) e uploads de arquivos (my.uploadFile).

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
url	String	Sim	O endereço do servidor do desenvolvedor.
filePath	String	Sim	O identificador local do recurso de arquivo para upload.
fileName	String	Sim	O nome do arquivo, que corresponde à chave associada. O desenvolvedor pode obter o conteúdo binário do arquivo no lado do servidor por meio dessa chave.
fileType	String	Sim	O tipo de arquivo: imagem, vídeo ou áudio.
hideLoading	Bool	Não	Especifique se o ícone de carregamento deve ser ocultado. O valor padrão é false.
header	Object	Não	O cabeçalho da requisição HTTP.
formData	Object	Não	Outros dados extras de formulário na requisição HTTP.
success	Function	Não	A função de callback para uma chamada bem-sucedida.
fail	Function	Não	A função de callback para uma chamada com falha.
complete	Function	Não	A função de callback executada ao final da chamada, independentemente de sucesso ou falha.

Valor de retorno de success

Nome	Tipo	Descrição
data	String	Os dados retornados pelo servidor.
statusCode	String	O código de status HTTP.
header	Object	O cabeçalho retornado pelo servidor.

Códigos de erro

error	Descrição	Soluções
11	O arquivo não existe.	Verifique se o arquivo local existe.
12	Falha no upload do arquivo.	Verifique a rede e o servidor.
13	Sem permissão.	Verifique as configurações de permissão.

Exemplo de código

Este exemplo serve apenas como referência. Use seu próprio endereço para testes.

my.uploadFile({
  url: 'Use your own server address',
  fileType: 'image',
  fileName: 'file',
  filePath: '...',
  success: (res) => {
    my.alert({
      content: 'Upload successful'
    });
  },
});

UploadTask

Um objeto que monitora alterações no progresso do upload e permite cancelar tarefas de upload.

Métodos

Método	Descrição
UploadTask.abort()	Interrompe a tarefa de upload.
UploadTask.onProgressUpdate(function callback)	Escuta eventos de mudança no progresso do upload.

Exemplo de código

const task = my.uploadFile({
  url: 'Use your own server address',
  fileType: 'image',
  fileName: 'file',
  filePath: '...',
});
task.onProgressUpdate(({progress, totalBytesWritten, totalBytesExpectedToWrite}) => {
})
task.abort()

Perguntas frequentes

P: Um miniapp pode converter automaticamente uma imagem enviada para Base64, que é um método de representar dados binários com caracteres imprimíveis?

R: Não, os miniapps não suportam a conversão de imagens para Base64.
P: Como posso usar my.uploadFile para recuperar mensagens de erro retornadas pelo servidor?

R:
- Recupere-a a partir do parâmetro data no callback success.
- Adicione uma API de recuperação de logs no lado do servidor. Se um upload falhar, chame a API de recuperação de logs para obter registros detalhados da falha.
P: Qual é o tempo limite padrão para my.uploadFile? É possível estender esse tempo limite?

R: O tempo limite padrão para my.uploadFile é de 30 s. Não, não é possível estender o tempo limite padrão.
P: Por que my.uploadFile reporta error: 12 ao fazer upload de um arquivo?

R: O código de erro 12 indica falha no upload. As possíveis causas incluem:
- O arquivo é muito grande.
- O upload levou mais de 30 s.
- Sem permissão.
P: O backend recebe uma imagem binária quando my.uploadFile é utilizado. Se o backend enviar essa imagem binária de volta para o miniapp, como o miniapp a interpreta?

R: O backend recebe a imagem como um fluxo binário. O backend precisa apenas fornecer a URL da localização da imagem no servidor.
P: Por que a chamada de my.uploadFile reporta error: 4, sem permissão para chamar esta API?

R: A URL solicitada não está na lista de permissões. Adicione o nome de domínio da URL à lista de permissões.
P: Os miniapps suportam upload de arquivos Excel?

R: Não. Atualmente, my.uploadFile suporta upload de arquivos do tipo imagem, vídeo ou áudio. Outros tipos de arquivo não são suportados.
P: my.uploadFile permite o upload simultâneo de várias imagens?

R: Não, my.uploadFile não suporta upload de múltiplas imagens ao mesmo tempo. É possível fazer upload de apenas uma imagem por vez.

my.downloadFile

Nota

Esta API é suportada no mPaaS 10.1.32 e versões posteriores.

Baixe um recurso de arquivo para o dispositivo local.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
url	String	Sim	O endereço do arquivo a ser baixado.
header	Object	Não	O cabeçalho da requisição HTTP.
success	Function	Não	A função de callback para uma chamada bem-sucedida.
fail	Function	Não	A função de callback para uma chamada com falha.
complete	Function	Não	A função de callback executada ao final da chamada, independentemente de sucesso ou falha.

Valor de retorno de success

Nome	Tipo	Descrição
apFilePath	String	O local temporário onde o arquivo é armazenado.

Códigos de erro

error	Descrição	Soluções
12	Falha no download.	Verifique a rede e o servidor.
13	Sem permissão.	Verifique as permissões.
20	A URL solicitada não suporta HTTP.	Altere a URL solicitada para usar HTTPS.

Exemplo de código

Este exemplo serve apenas como referência. Use seu próprio endereço para testes.

// API-DEMO page/API/download-file/download-file.json
{
    "defaultTitle": "Download File"
}

<!-- API-DEMO page/API/download-file/download-file.axml-->
<view class="container">
  <button onTap="download">Download and display image</button>
</view>

// API-DEMO page/API/download-file/download-file.js
Page({
  download() {
    my.downloadFile({
      url: 'https://img.alicdn.com/tfs/TB1x669SXXXXXbdaFXXXXXXXXXX-520-280.jpg',
      success({ apFilePath }) {
        my.previewImage({
          urls: [apFilePath],
        });
      },
      fail(res) {
        my.alert({
          content: res.errorMessage || res.error,
        });
      },
    });
  },
})

my.connectSocket

Nota

Esta API é suportada no mPaaS 10.1.60 e versões posteriores.

Cria uma conexão WebSocket.

Um miniapp pode ter apenas uma conexão WebSocket por vez. Se já existir uma conexão WebSocket ativa, ela será fechada automaticamente e uma nova será criada.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
url	String	Sim	A URL do servidor de destino. Nota: Alguns miniapps lançados recentemente suportam apenas o protocolo wss.
data	Object	Não	Os parâmetros da requisição.
header	Object	Não	Defina o cabeçalho da requisição.
success	Function	Não	A função de callback para uma chamada bem-sucedida.
fail	Function	Não	A função de callback para uma chamada com falha.
complete	Function	Não	A função de callback executada ao final da chamada, independentemente de sucesso ou falha.

Códigos de erro

error	Descrição	Soluções
1	Erro desconhecido.	-
2	A conexão de rede já existe.	Um miniapp pode ter apenas uma conexão WebSocket por vez. Se já existir uma conexão WebSocket, ela é fechada automaticamente e uma nova é criada.
3	O parâmetro URL está vazio.	Substitua a URL.
4	Formato de URL não reconhecido.	Forneça uma URL com formato válido.
5	A URL deve começar com `ws` ou `wss`.	Substitua a URL.
6	Tempo limite de conexão com o servidor esgotado.	Tente novamente mais tarde.
7	O certificado HTTPS retornado pelo servidor é inválido.	Miniapps devem usar HTTPS ou WSS para iniciar requisições de rede. Quando uma requisição é feita, o sistema verifica o certificado HTTPS usado pelo nome de domínio do servidor. Se a verificação falhar, a requisição não poderá ser iniciada. Devido a limitações do sistema, diferentes plataformas têm níveis variados de rigor nos requisitos de certificados. Para garantir compatibilidade, configure os certificados seguindo os padrões mais altos e use ferramentas relevantes para verificar se seus certificados atuais atendem aos requisitos.
8	O cabeçalho de protocolo retornado pelo servidor é inválido.	A partir de maio de 2019, miniapps recém-criados devem usar os protocolos HTTPS e WSS. Os protocolos HTTP e WS não são mais suportados.
9	A requisição WebSocket não especificou o cabeçalho `Sec-WebSocket-Protocol`.	Especifique o cabeçalho de requisição `Sec-WebSocket-Protocol`.
10	A conexão de rede não está aberta, portanto, não é possível enviar mensagens.	Conecte-se ao servidor antes de chamar my.sendSocketMessage para enviar uma mensagem de dados. Use my.onSocketOpen para escutar o evento e determinar se uma conexão correta foi estabelecida com o servidor. Nota: Para enviar dados por uma conexão WebSocket, primeiro use my.connectSocket para iniciar a conexão. Depois, chame my.sendSocketMessage para enviar dados após o callback my.onSocketOpen.
11	Falha no envio da mensagem.	Tente novamente mais tarde.
12	Não foi possível solicitar mais memória para ler dados de rede.	Verifique a memória.

Exemplo de código

Este exemplo serve apenas como referência. Use seu próprio endereço para testes.

my.connectSocket({
  url: 'test.php',
  data: {},
  header:{
    'content-type': 'application/json'
  },
});

my.onSocketOpen

Nota

Esta API é suportada no mPaaS 10.1.60 e versões posteriores.

Escuta o evento de abertura de conexão WebSocket.

Parâmetros de entrada

Tipo Object com as seguintes propriedades:

Propriedade	Tipo	Obrigatório	Descrição
callback	Function	Sim	A função de callback para o evento de abertura de conexão WebSocket.

Exemplo de código

Este exemplo serve apenas como referência. Use seu próprio endereço para testes.

my.connectSocket({
  url: 'test.php',
});

my.onSocketOpen(function(res) {
  console.log('WebSocket connection is open!');
});

my.offSocketOpen

Nota

Esta API é suportada no mPaaS 10.1.60 e versões posteriores.

Para de escutar o evento de abertura de conexão WebSocket.

Exemplo de código

Este exemplo serve apenas como referência. Use seu próprio endereço para testes.

Page({
  onLoad() {
    this.callback = this.callback.bind(this);
    my.onSocketOpen(this.callback);
  },
  onUnload() {
    my.offSocketOpen(this.callback);
  },
  callback(res) {
  },
})

Passagem de valor de callback

Se nenhum valor de callback for passado, todos os callbacks de evento deste listener serão removidos. Exemplo:
```
my.offSocketOpen();
```
Se um valor de callback for passado, apenas o evento de callback correspondente será removido. Exemplo:
```
my.offSocketOpen(this.callback);
```

my.onSocketError

Nota

Esta API é suportada no mPaaS 10.1.60 e versões posteriores.

Escuta erros de WebSocket.

Parâmetros de entrada

Tipo Object com as seguintes propriedades:

Parâmetro	Tipo	Obrigatório	Descrição
callback	Function	Sim	A função de callback para o evento de erro de WebSocket.

Exemplo de código

Este exemplo serve apenas como referência. Use seu próprio endereço para testes.

my.connectSocket({
  url: 'Your server address'
});

my.onSocketOpen(function(res){
  console.log('WebSocket connection is open!');
});

my.onSocketError(function(res){
  console.log('WebSocket connection failed. Please check!');
});

my.offSocketError

Nota

Esta API é suportada no mPaaS 10.1.60 e versões posteriores.

Para de escutar erros de WebSocket.

Exemplo de código

Este exemplo serve apenas como referência. Use seu próprio endereço para testes.

Page({
  onLoad() {
    this.callback = this.callback.bind(this);
    my.onSocketError(this.callback);
  },
  onUnload() {
    my.offSocketError(this.callback);
  },
  callback(res) {
  },
})

Passagem de valor de callback

Se nenhum valor de callback for passado, todos os callbacks de evento deste listener são removidos. Exemplo:
```
my.offSocketError();
```
Se um valor de callback for passado, somente o evento de callback correspondente é removido. Exemplo:
```
my.offSocketError(this.callback);
```

my.sendSocketMessage

Nota

Esta API é suportada no mPaaS 10.1.60 e versões posteriores.

Envia dados através de uma conexão WebSocket. Primeiro, use my.connectSocket para iniciar a conexão e, em seguida, envie os dados após o callback my.onSocketOpen.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
data	String	Sim	O conteúdo a ser enviado: uma string de texto simples ou uma string codificada em Base64.
isBuffer	Boolean	Não	Para enviar dados binários, codifique os dados de entrada em Base64 como uma string, atribua-os a `data` e defina este campo como true. Se os dados forem uma string de texto simples, não é necessário definir este campo.
success	Function	Não	A função de callback.
fail	Function	Não	A função de callback para uma chamada com falha.
complete	Function	Não	A função de callback executada ao final da chamada, independentemente de sucesso ou falha.

Exemplo de código

Este exemplo serve apenas como referência. Use seu próprio endereço para testes.

my.sendSocketMessage({
    data: this.data.toSendMessage, // The content to send
    success: (res) => {
        my.alert({content: 'Data sent! ' + this.data.toSendMessage});
    },
});

my.onSocketMessage

Nota

Esta API é suportada no mPaaS 10.1.60 e versões posteriores.

Escuta mensagens recebidas do servidor através de uma conexão WebSocket.

Valor de retorno do callback

Nome	Tipo	Descrição
data	String/ArrayBuffer	A mensagem retornada pelo servidor: uma string de texto simples ou uma string codificada em Base64.
isBuffer	Boolean	Se este campo for `true`, o campo `data` representa uma string codificada em Base64 recebida. Caso contrário, o campo `data` representa uma string de texto simples recebida.

Exemplo de código

Este exemplo serve apenas como referência. Use seu próprio endereço para testes.

my.connectSocket({
  url: 'Server address'
})

my.onSocketMessage(function(res) {
  console.log('Received server content: ' + res.data)
})

my.offSocketMessage

Nota

Esta API é suportada no mPaaS 10.1.60 e versões posteriores.

Para de escutar mensagens recebidas do servidor através de uma conexão WebSocket.

Exemplo de código

Este exemplo serve apenas como referência. Use seu próprio endereço para testes.

my.connectSocket({
  url: 'Server address'
})
my.onSocketMessage(function(res) {
  console.log('Received server content: ' + res.data)
})
my.offSocketMessage();

Passagem de valor de callback

Se nenhum valor de callback for passado, todos os callbacks de evento deste listener serão removidos. Exemplo:
```
my.offSocketMessage();
```
Se um valor de callback for passado, apenas o evento de callback correspondente será removido. Exemplo:
```
my.offSocketMessage(this.callback);
```

my.closeSocket

Nota

Esta API é suportada no mPaaS 10.1.60 e versões posteriores.

Fecha uma conexão WebSocket.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
success	Function	Não	A função de callback.
fail	Function	Não	A função de callback para uma chamada com falha.
complete	Function	Não	A função de callback executada ao final da chamada, independentemente de sucesso ou falha.

Exemplo de código

Este exemplo serve apenas como referência. Use seu próprio endereço para testes.

my.onSocketOpen(function() {
  my.closeSocket()
})

my.onSocketClose(function(res) {
  console.log('WebSocket connection is closed!')
})

my.onSocketClose

Nota

Esta API é suportada no mPaaS 10.1.60 e versões posteriores.

Escuta o evento de fechamento de conexão WebSocket.

Parâmetros de entrada

Tipo Object com as seguintes propriedades:

Parâmetro	Tipo	Obrigatório	Descrição
callback	Function	Sim	A função de callback para o evento de fechamento de conexão WebSocket.

Exemplo de código

Este exemplo serve apenas como referência. Use seu próprio endereço para testes.

onLoad() {
    // Note: Register the callback method only once during the miniapp startup phase.
    // If you call it multiple times, the callback will be triggered multiple times.
    my.onSocketClose((res) => {
      my.alert({content: 'Connection closed!'});
      this.setData({
        sendMessageAbility: false,
        closeLinkAbility: false,
      });
    });
    // Note: Register the callback method only once during the miniapp startup phase.
    // If you call it multiple times, the callback will be triggered multiple times.
    my.onSocketOpen((res) => {
      my.alert({content: 'Connection opened!'});
      this.setData({
        sendMessageAbility: true,
        closeLinkAbility: true,
      });
    });

    my.onSocketError(function(res){
      my.alert('WebSocket connection failed. Please check! ' + res);
    });

    // Note: Register the callback method only once during the miniapp startup phase.
    // If you call it multiple times, the callback will be triggered multiple times.
    my.onSocketMessage((res) => {
      my.alert({content: 'Data received! ' + JSON.stringify(res)});
    });
  }

connect_start() {
    my.connectSocket({
      url: 'Server address', // The developer's server API address. It must use the wss protocol, and the domain name must be a legitimate domain name configured in the backend.
      success: (res) => {
        my.showToast({
          content: 'success', // Text content
        });
      },
      fail:()=>{
        my.showToast({
          content: 'fail', // Text content
        });
      }
    });
  },

my.offSocketClose

Nota

Esta API é suportada no mPaaS 10.1.60 e versões posteriores.

Para de escutar o evento de fechamento de conexão WebSocket.

Exemplo de código

Este exemplo serve apenas como referência. Use seu próprio endereço para testes.

Page({
  onLoad() {
  my.onSocketClose(this.callback);
  },
  onUnload() {
    my.offSocketClose(this.callback);
    //    my.offSocketClose();
  },
  callback(res) {
  my.alert({content: 'Connection closed!'});
      this.setData({
        sendMessageAbility: false,
        closeLinkAbility: false,
      });
  },
})

Passagem de valor de callback

Se nenhum valor de callback for passado, todos os callbacks de evento deste listener serão removidos. Exemplo:
```
my.offSocketClose();
```
Se um valor de callback for passado, apenas o evento de callback correspondente será removido. Exemplo:
```
my.offSocketClose(this.callback);
```

my.rpc(Object)

Uma API dedicada de chamada de procedimento remoto (RPC) para o framework de miniapp. Trata-se da API de gateway do miniapp.

Descrição dos parâmetros

Nome	Tipo	Obrigatório	Descrição
operationType	String	Sim	O operationType do gateway.
requestData	Array	Não	Os dados da requisição do gateway.
success	Function	Não	A função de callback para uma chamada bem-sucedida.
fail	Function	Não	A função de callback para uma chamada com falha.
complete	Function	Não	A função de callback executada ao final da chamada, independentemente de sucesso ou falha.

Exemplo de código

Este exemplo serve apenas como referência. Use seu próprio endereço para testes.

my.rpc({
      operationType: 'com.xx.xx',
      requestData: [{
        "param1":"",
        "param2":0
      }],
      success: res => {
      },
      fail: res => {
      }
});