Plataformas Suportadas: Dispositivos Elo com Android 12 e Android 14, incluindo Backpack 4 (Standard/Value), I-Series 4 (Standard/Value), I-Series Standard, M50, Elo Pay M60, Elo Pay 7”, Elo Pay 22", M100, M100C.
Referência Completa (Base de Conhecimento + SDK Javadoc)
As APIs estão organizadas por classe funcional (Sistema, Rede, Pacote, etc.) para simplificar a descoberta e acelerar a implementação.
Melhores Práticas Globais (da KB)
-
Sempre vincule ao serviço antes de chamar qualquer API.
Não invoque métodos até queonServiceConnected()seja recebido. -
Assuma que a política do dispositivo pode substituir configurações locais.
Isso é especialmente verdadeiro para hora, fuso horário, USB, modo quiosque e instalação de aplicações. -
Use NTP para sincronização de hora em produção.
Evite configuração manual da hora, exceto para testes. -
Entenda o comportamento de redefinição.
-
Redefinição Empresarial limpa a configuração da Elo e o estado de inscrição.
-
Redefinição de Fábrica apaga todos os dados do usuário e retorna o dispositivo ao estado de saída de caixa.
-
-
Registre o resultado de cada chamada de API.
Isso é crítico para solução de problemas e escalonamento.
❗ Notas Importantes de Uso
Algumas APIs do SDK exigem permissões específicas do Android e podem se comportar de maneira diferente dependendo se o dispositivo está no modo EloView ou no modo Android Home. O cumprimento da política do dispositivo pode substituir as configurações aplicadas localmente. Os desenvolvedores devem validar o modo do dispositivo e o estado da permissão antes de invocar APIs em aplicações de produção.
O EloView Home SDK é um SDK Android baseado em serviços e requer uma vinculação de serviço bem-sucedida antes que qualquer chamada de API possa ser executada. Os métodos podem retornar nulo ou nenhum resultado se:
- O serviço ainda não está conectado
- O dispositivo não está em um estado EloView compatível
- Restrições de política bloqueiam a operação
Este guia se concentra em padrões suportados e comumente utilizados. Ele não enumera cada permissão Android, caso de borda do ciclo de vida ou estado interno de retorno documentado no SDK Javadoc bruto. O tratamento padrão do ciclo de vida dos serviços Android e a verificação de erros devem ser implementados em aplicações de produção.
Cenários Comuns do Mundo Real (da KB)
Cenário: Fuso horário incorreto após a inscrição do dispositivo
system.setNtpEnabled(true);
system.setNtpServer("time.aws.com");
system.setTimeZone("US/Central");
system.syncTimeNow();
// Verifique
String tz = system.getTimeZone();
Log.d(TAG, "Timezone=" + tz);
Dica: Se o fuso horário reverter após a reinicialização, verifique se o recurso de hora automática do Android está ativado e se a política do dispositivo não está reaplicando uma região diferente.
Cenário: Configurar modo quiosque de única aplicação de forma segura
pkg.setKioskApp("com.example.kiosk");
pkg.setKioskModeEnabled(true);
pkg.launchApp("com.example.kiosk");
Aviso: Sempre valide um caminho de escape administrativo antes de ativar o modo quiosque em produção.
Modelo de Vinculação de Serviço (da KB)
eloView.bindService(context, callback, accessToken);
// Seguro chamar APIs do SDK dentro callback.onServiceConnected()
eloView.unbindService(context);
Nota importante: bindService() e unbindService() não retornam valores. As APIs do SDK devem ser invocadas apenas após onServiceConnected() ser chamado.
APIs Básicas / de Vinculação de Serviço
EloView
A classe EloView fornece as seguintes operações:
- Defina o conteúdo a ser reproduzido no dispositivo em modo de Controle EloView quando o dispositivo estiver offline ou não registrado em uma conta usando setOfflinePlayContent().
- Recupere o tipo de conteúdo (APK ou WebView) e o nome do conteúdo atualmente definido em modo de Controle EloView usando getPlayContent().
- Obtenha o status de reprodução atual do conteúdo configurado em modo de Controle EloView usando getPlayContentStatus().
- Verifique se o dispositivo está atualmente conectado ao EloView Cloud (online ou offline) usando getDeviceCloudStatus().
- Ative ou desative o Wi-Fi nas Configurações Rápidas da Elo e no Modo Android Home usando toggleWifi().
- Ative ou desative o Bluetooth nas Configurações Rápidas da Elo e no Modo Android Home usando toggleBT().
bindService
public void bindService(android.content.Context context, ServiceConnectionCallback callback, java.lang.String accessToken)
Este método vincula o serviço EloView ao aplicativo. Você deve chamar isso antes de invocar qualquer API do EloView.
Parâmetros
- context – Contexto no qual as APIs do EloView são utilizadas.
try {
// TODO: garantir que o serviço está vinculado antes de chamar APIs do SDK
Object result = sdk.bindService(context, callback, "accessToken");
Log.d(TAG, "OK: bindService result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: bindService", e);
}
unbindService
public void unbindService(android.content.Context context)
Este método é usado para desvincular o serviço do aplicativo. Use este método para desvincular o serviço do aplicativo ao limpar recursos.
Parâmetros
- context – Contexto
Exemplo
try {
// TODO: garantir que o serviço está vinculado antes de chamar APIs do SDK
Object result = sdk.unbindService(context);
Log.d(TAG, "OK: unbindService result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: unbindService", e);
}
setOfflinePlayContent
public java.lang.String setOfflinePlayContent(java.lang.String packageName)
Este método é usado para definir o conteúdo no dispositivo em modo de Controle EloView quando o dispositivo está offline ou não registrado em uma conta. Se o dispositivo ficar online e o conteúdo for definido através do EloView, ele substituirá o conteúdo definido através desta API.
Parâmetros
- packageName – Pacote a ser definido como conteúdo padrão no dispositivo.
Exemplo
try {
// TODO: garantir que o serviço está vinculado antes de chamar APIs do SDK
Object result = sdk.setOfflinePlayContent("packageName");
Log.d(TAG, "OK: setOfflinePlayContent result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: setOfflinePlayContent", e);
}
getPlayContent
public java.lang.String getPlayContent()
Este método retorna o tipo de conteúdo e o nome do conteúdo definido no dispositivo. Este método funciona apenas em modo de Controle EloView.
Exemplo
try {
// TODO: garantir que o serviço está vinculado antes de chamar APIs do SDK
Object result = sdk.getPlayContent();
Log.d(TAG, "OK: getPlayContent result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: getPlayContent", e);
}
getPlayContentStatus
public java.lang.String getPlayContentStatus()
Este método retorna o status do conteúdo de reprodução no dispositivo no modo de Controle. O status pode ser uma das seguintes strings:
YET_TO_DOWNLOAD, DOWNLOADING, DOWNLOADED, INSTALLING, INSTALLED, DOWNLOAD_FAILED, INSTALL_FAILED, UNKNOWN_STATUS
Exemplo
try {
// TODO: garantir que o serviço está vinculado antes de chamar APIs do SDK
Object result = sdk.getPlayContentStatus();
Log.d(TAG, "OK: getPlayContentStatus result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: getPlayContentStatus", e);
}
getDeviceCloudStatus
public java.lang.String getDeviceCloudStatus()
Este método retorna o status online ou offline do dispositivo. O status pode ser uma das seguintes strings: "Online", "Offline", "Connecting", "Reconnecting", "Online (Not Provisioned)".
Exemplo
try {
// TODO: garantir que o serviço está vinculado antes de chamar APIs do SDK
Object result = sdk.getDeviceCloudStatus();
Log.d(TAG, "OK: getDeviceCloudStatus result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: getDeviceCloudStatus", e);
}
toggleWifi
void toggleWifi(boolean isEnableWifi)
Ativa ou desativa o Wi-Fi no dispositivo. Isso se aplica tanto no modo EloView quanto no modo Android Home.
Parâmetros
- isEnableWifi – Booleano para ativar ou desativar o Wi-Fi nas Configurações Rápidas.
Exemplo
try {
// TODO: garantir que o serviço está vinculado antes de chamar APIs do SDK
Object result = sdk.toggleWifi(true);
Log.d(TAG, "OK: toggleWifi result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: toggleWifi", e);
}
switchToAndroidHomeMode
void switchToAndroidHomeMode() void switchToAndroidHomeMode(boolean isRebootNeeded, boolean isAndroidHomeMode)
Este método é usado para alternar para o modo Android Home a partir do modo EloView. Esta é a mesma coisa que switchToAndroidHomeMode(), exceto que aceita dois parâmetros booleanos. Não há como voltar para o modo EloView sem uma redefinição de fábrica, portanto, use com cautela.
Parâmetros
- Alterna o dispositivo do modo EloView para o modo Android Home.
- Se isRebootNeeded for definido como verdadeiro, o dispositivo irá reiniciar para aplicar a mudança de modo.
- Nota importante: Alternar para o modo Android Home pode desativar restrições e políticas gerenciadas pelo EloView.
Exemplo
try {
// TODO: garantir que o serviço está vinculado antes de chamar APIs do SDK
Object result = sdk.switchToAndroidHomeMode(true, true);
Log.d(TAG, "OK: switchToAndroidHomeMode result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: switchToAndroidHomeMode", e);
}
toggleBT
public int toggleBT(boolean isEnableBT)
Este método é usado para alternar o Bluetooth nas Configurações Rápidas (modo EloView). Também pode ser usado para alternar o Bluetooth no modo Android Home.
Parâmetros
- isEnableBT – Booleano para ativar ou desativar o Bluetooth nas Configurações Rápidas.
Exemplo
try {
// TODO: garantir que o serviço está vinculado antes de chamar APIs do SDK
Object result = sdk.toggleBT(true);
Log.d(TAG, "OK: toggleBT result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: toggleBT", e);
}
APIs de Conta
AccountManager
A classe AccountManager fornece as seguintes operações:
1. Fornecer um Token de Autenticação de um EloServer com base nas credenciais fornecidas pelo usuário (emailId/senha ou clientId/secretKey).
2. Verifique se um determinado Token de Autenticação é válido ou expirou. O token de autenticação pode ser o token obtido do servidor EloView ou pode ser um token JWT offline fornecido pela equipe de Suporte Elo. (O token offline é gerado usando o nome do pacote do seu aplicativo e só pode ser usado com o pacote para o qual foi gerado.)
3. Todas as APIs exigem um token offline para funcionar e não funcionarão com um token online. A única exceção são as APIs OTA. As APIs OTA exigem o token online ao aplicar o OTA de um servidor EloView. Para aplicar o OTA através de uma URL de servidor personalizado ou de um arquivo local no dispositivo, o token offline pode ser usado.
Exemplo, para obter um Token de Autenticação:
1. Usando emailId e senha, chame getEloAccessToken. 2. Usando clientId e secretKey, chame getEloOAuthToken. Após a autenticação bem-sucedida, esses métodos irão retornar um token. 3. Para o token JWT offline, entre em contato com a equipe de Suporte Elo.
O token recuperado do servidor ou da equipe de suporte é verificado usando o método verifyEloToken.
Desregistre os receptores de transmissão usados por essas APIs do AccountManager usando o método unregisterAccountManagerListener nos métodos onPause e onDestroy das atividades nas quais você usa essas APIs para evitar vazamentos.
getProperty
public static java.lang.String getProperty()
Exemplo
try {
// TODO: garantir que o serviço está vinculado antes de chamar APIs do SDK
Object result = sdk.getProperty();
Log.d(TAG, "OK: getProperty result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: getProperty", e);
}
setProperty
public void setProperty(java.lang.String property)
Exemplo
try {
// TODO: garantir que o serviço está vinculado antes de chamar APIs do SDK
Object result = sdk.setProperty("property");
Log.d(TAG, "OK: setProperty result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: setProperty", e);
}
getClientId
public static java.lang.String getClientId()
Exemplo
try {
// TODO: garantir que o serviço está vinculado antes de chamar APIs do SDK
Object result = sdk.getClientId();
Log.d(TAG, "OK: getClientId result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: getClientId", e);
}
getBaseUri
public static android.net.Uri getBaseUri()
Exemplo
try {
// TODO: garantir que o serviço está vinculado antes de chamar APIs do SDK
Object result = sdk.getBaseUri();
Log.d(TAG, "OK: getBaseUri result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: getBaseUri", e);
}
getEloAccessToken
public void getEloAccessToken(android.content.Context context, java.lang.String userEmail, java.lang.String password, android.os.Handler handler)
Este método é usado para obter um token de acesso do servidor Elo.
Parâmetros
- context – Um objeto Context da classe chamadora (Activity ou Service).
Exemplo
try {
// TODO: garantir que o serviço está vinculado antes de chamar APIs do SDK
Object result = sdk.getEloAccessToken(context, "userEmail", "password", handler);
Log.d(TAG, "OK: getEloAccessToken result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: getEloAccessToken", e);
}
configureOAuthHostedUI
public void configureOAuthHostedUI(android.app.Activity activity, android.os.Handler handler)
Este método é usado para inicializar a interface do usuário hospedada OAuth.
Parâmetros
- activity – Uma instância da Activity da classe chamadora.
Exemplo
try {
// TODO: garantir que o serviço está vinculado antes de chamar APIs do SDK
Object result = sdk.configureOAuthHostedUI(activity, handler);
Log.d(TAG, "OK: configureOAuthHostedUI result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: configureOAuthHostedUI", e);
}
stopOAuth
public void stopOAuth()
Chame stopOAuth no método onStop() da atividade sobreposta.
Exemplo
try {
// TODO: garantir que o serviço está vinculado antes de chamar APIs do SDK
Object result = sdk.stopOAuth();
Log.d(TAG, "OK: stopOAuth result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: stopOAuth", e);
}
destroyOAuth
public void destroyOAuth()
Chame destroyOAuth no método onStop() da atividade sobreposta.
Exemplo
try {
// TODO: garantir que o serviço está vinculado antes de chamar APIs do SDK
Object result = sdk.destroyOAuth();
Log.d(TAG, "OK: destroyOAuth result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: destroyOAuth", e);
}
logoutOAuth
public void logoutOAuth()
Chame logoutOAuth para encerrar a sessão de login atual.
Exemplo
try {
// TODO: garantir que o serviço está vinculado antes de chamar APIs do SDK
Object result = sdk.logoutOAuth();
Log.d(TAG, "OK: logoutOAuth result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: logoutOAuth", e);
}
verifyEloToken
public void verifyEloToken(android.content.Context context, java.lang.String accessToken, android.os.Handler handler)
Esta função solicita ao servidor Elo que verifique o token fornecido. Após a verificação bem-sucedida, o manipulador receberá uma mensagem do tipo TOKEN_VERIFY_SUCCESS. Em caso de falha, TOKEN_VERIFY_FAIL será recebido.
Parâmetros
- context – Um objeto Context da classe chamadora (Activity ou Service).
Exemplo
try {
// TODO: garantir que o serviço está vinculado antes de chamar APIs do SDK
Object result = sdk.verifyEloToken(context, "accessToken", handler);
Log.d(TAG, "OK: verifyEloToken result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: verifyEloToken", e);
}
getEloOAuthToken
public void getEloOAuthToken(android.content.Context context, java.lang.String clientID, java.lang.String secret, android.os.Handler handler)
Este método é usado para solicitar ao portal EloView um novo token OAuth. Após a autenticação bem-sucedida, um token será enviado ao dispositivo. Este token é válido para uso durante 24 horas após ser emitido. Quando o token expirar, tentativas adicionais de verificar o token e chamar APIs resultarão na resposta TOKEN_VERIFY_FAIL. O mesmo é verdadeiro se um token nunca foi obtido ou recebido.
Se bem-sucedido, o manipulador receberá uma mensagem do tipo OAUTH_TOKEN_VALID com um token JWT como resposta. Abaixo está um exemplo de uma resposta bem-sucedida:
"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6IlJQTSJ9.eyJ1ZW1haWwiOiJwcmF0YXBlbG8rUHJvZEBnbWFpbC5jb20iLCJvdGl0bGUiOiJwcmF0YXBlbG8rUHJvZEBnbWFpbC5jb20iLCJjYXAiOnsiY3JjIjoiSDIvb2RnIiwicGVybSI6ImZmZmZmZmYwMCJ9LCJpYXQiOjE1MjUxMTc4NDgsIm5iZiI6MTUyNTExNzg0OCwiZXhwIjoxNTI1MjA0MjQ4LCJpc3MiOiIxNTAyIiwic3ViIjoiZWVhNDRkY2JkMjU5YzQyOWY4NTA3YWZhNTQyY2Q3M2YiLCJqdGkiOiJ2ZE14N1ppUGVnWT0ifQ.b2e-F1mVh0ummkBJk3m8pT2qSCceRxuS_A9GAKtYBeo"
Em caso de falha de autenticação devido a um bad clientID ou secretID, o manipulador receberá uma mensagem do tipo OAUTH_TOKEN_INVALID.
Parâmetros
- context – Um objeto Context da classe chamadora (Activity ou Service).
Exemplo
try {
// TODO: garantir que o serviço está vinculado antes de chamar APIs do SDK
Object result = sdk.getEloOAuthToken(context, "clientID", "secret", handler);
Log.d(TAG, "OK: getEloOAuthToken result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: getEloOAuthToken", e);
}
unregisterAccountManagerListener
public void unregisterAccountManagerListener(android.content.Context context)
Este método é usado para desregistrar o receptor de transmissão registrado enquanto utilizava qualquer uma das APIs do AccountManager. Certifique-se de chamar isso nos métodos onPause e onDestroy em sua atividade ciclo de vida caso tenha utilizado qualquer uma das APIs do AccountManager. Isso garante que o receptor não seja vazado.
Parâmetros
- context – Contexto em que as APIs do sistema foram usadas.
- context – Contexto Android usado para desregistrar o listener do gerenciador de contas.
Exemplo
try {
// TODO: garantir que o serviço está vinculado antes de chamar APIs do SDK
Object result = sdk.unregisterAccountManagerListener(context);
Log.d(TAG, "OK: unregisterAccountManagerListener result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: unregisterAccountManagerListener", e);
}
setDefaultEnvironment
public void setDefaultEnvironment(android.content.Context ctx)
Exemplo
try {
// TODO: garantir que o serviço está vinculado antes de chamar APIs do SDK
Object result = sdk.setDefaultEnvironment(context);
Log.d(TAG, "OK: setDefaultEnvironment result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: setDefaultEnvironment", e);
}
selectEnvironment
public void selectEnvironment(android.content.Context ctx, java.lang.String prop, boolean isSealed)
Exemplo
try {
// TODO: garantir que o serviço está vinculado antes de chamar APIs do SDK
Object result = sdk.selectEnvironment(context, "prop", true);
Log.d(TAG, "OK: selectEnvironment result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: selectEnvironment", e);
}
isPolarisLocked
public boolean isPolarisLocked(android.content.Context context)
Exemplo
try {
// TODO: garantir que o serviço está vinculado antes de chamar APIs do SDK
Object result = sdk.isPolarisLocked(context);
Log.d(TAG, "OK: isPolarisLocked result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: isPolarisLocked", e);
}
getEnvironment
public java.lang.String getEnvironment(android.content.Context ctx)
Exemplo
try {
// TODO: garantir que o serviço está vinculado antes de chamar APIs do SDK
Object result = sdk.getEnvironment(context);
Log.d(TAG, "OK: getEnvironment result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: getEnvironment", e);
}
isPolaris
public boolean isPolaris(android.content.Context context)
Exemplo
try {
// TODO: garantir que o serviço está vinculado antes de chamar APIs do SDK
Object result = sdk.isPolaris(context);
Log.d(TAG, "OK: isPolaris result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: isPolaris", e);
}
TokenListener
TokenListener ouve eventos de verificação de AuthenticationToken e, em um token válido, fornece a resposta de sucesso para realizar mais operações.
Nenhum método está documentado para este tipo.
APIs do Sistema
ServiceConnectionCallback
onServiceConnected
void onServiceConnected()
Este método é chamado quando o serviço está conectado após chamar bindService.
Exemplo
try {
// TODO: garantir que o serviço está vinculado antes de chamar APIs do SDK
Object result = sdk.onServiceConnected();
Log.d(TAG, "OK: onServiceConnected result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: onServiceConnected", e);
}
onServiceDisconnected
void onServiceDisconnected()
Este método é chamado quando o serviço está desconectado. Isso não será chamado se o serviço for desvinculado usando unbindService.
Exemplo
try {
// TODO: garantir que o serviço está vinculado antes de chamar APIs do SDK
Object result = sdk.onServiceDisconnected();
Log.d(TAG, "OK: onServiceDisconnected result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: onServiceDisconnected", e);
}
Sistema
A classe Sistema fornece as seguintes operações:
-
Obtenha um token de autenticação usando
getEloAccessToken. -
Capture a captura de tela do dispositivo usando
captureScreenShot. -
Defina a orientação do dispositivo (retrato, paisagem, retrógrado-retrato, retrógrado-paisagem)
usando
setOrientation. -
Obtenha a orientação do dispositivo usando
getOrientation. -
Redefina o dispositivo para o estado de fábrica usando
factoryReset. -
Reinicialize o dispositivo silenciosamente usando
silentReboot. -
Habilite ou desabilite a Barra de Navegação usando
setNavigationBarEnabled. -
Habilite ou desabilite a Barra de Status usando
setStatusBarEnabled. -
Conceda todas as permissões de tempo de execução usando
setGrantAllAppPermissionEnabled. -
Obtenha o status da Barra de Navegação usando
getNavigationBarEnabled. -
Obtenha o status da Barra de Status usando
getStatusBarEnabled. -
Obtenha o status da concessão de todas as permissões de aplicativo usando
getGrantAllAppPermissionEnabled. -
Defina e obtenha o tempo limite de retroiluminação usando
setBacklightTimeOutegetBacklightTimeOut. -
Defina e mude a senha da tela de bloqueio usando
setLockScreenPasswordechangeLockScreenPassword. -
Permita automaticamente permissões USB usando
autoAllowUSBPermission. -
Bloqueie ou desbloqueie o firmware do processador seguro usando
setFirmwareStatusLockEnabled. -
Defina e mude o PIN do dispositivo usando
setLockScreenPinechangeLockScreenPin. -
Habilite ou desabilite WiFi usando
setWifiEnablede obtenha o status usandogetWifiEnabled. -
Limpe o cache e os dados do aplicativo usando
clearAllAppCacheUserDataeclearAppCacheUserData. -
Habilite ADB usando
setAdbEnablede configure a porta personalizada usandocustomPortAdb. -
Habilite ou desabilite o botão Início usando
setHomeButtonEnabled. -
Habilite ou desabilite o botão de energia usando
setPowerButtonEnabled. -
Habilite ou desabilite o menu de assistência do editor de texto usando
setTextEditorAssistMenuEnabled. -
Habilite ou desabilite o painel de volume "Mostrar mais" usando
setVolumePanelShowMoreEnabled. -
Habilite ou desabilite o scanner de código de barras Zebra usando
setBarcodeReaderEnabled. -
Acione a leitura de código de barras usando
setScanBarcodeReaderEnabled. -
Habilite ou desabilite o registro da Elo usando
setEloLoggingEnabled. -
Habilite ou desabilite um MAC WiFi aleatório usando
setRandomWifiMacAddressEnabled. -
Habilite ou desabilite o acesso WebView da impressora Star usando
setStarPeripheralConnectEnabled. -
Verifique o status de auto-permissão USB usando
getAutoAllowUSBPermission. -
Configure, remova e consulte o proprietário do dispositivo usando
setDeviceOwner,removeDeviceOwneregetDeviceOwnerStatus. -
Defina e obtenha DPI de tela usando
setDpiegetDpi. -
Defina e obtenha o idioma usando
setLanguageegetLanguage. -
Defina e obtenha o tipo de bloqueio usando
setLockTypeegetLockType. -
Habilite ou desabilite IME Multi Cliente usando
setMultiClientImeEnabledegetMultiClientImeEnabled. -
Defina e obtenha o servidor NTP usando
setNtpServerUrlegetNtpServerUrl. -
Defina e obtenha o intervalo de pesquisa NTP usando
setNtpPollIntervalegetNtpPollInterval. -
Controle permissões de instalação usando
setInstallPermissionToSpecificApp,setInstallAllAppPermissionEnabledegetInstallPermissionToSpecificApp. -
Defina e obtenha o tamanho da tela usando
setScreenSizeegetScreenSize. -
Defina e obtenha a menor largura de pixel usando
setSmallestPixelWidthegetSmallestPixelWidth. -
Defina e obtenha o fuso horário usando
setTimeZoneegetTimeZone. -
Habilite ou desabilite serviços de acessibilidade usando
setAccessibilityService. -
Habilite ou desabilite data e hora automáticas usando
setAutoDateTimeEnabled. -
Habilite ou desabilite a confirmação de emparelhamento de Bluetooth usando
setBluetoothDevicePairingConfirmationEnabled. -
Defina data e hora usando
setDateTime. -
Defina o tamanho da tela usando
setDisplaySize. -
Configure o WiFi usando CSV com
setEloNetworkConf. -
Defina o tamanho da fonte usando
setFontSize. -
Habilite ou desabilite o modo ocioso usando
setIdleModeEnabled. -
Habilite ou desabilite a localização usando
setLocationEnabled. -
Silencie ou desmute o microfone usando
setMicrophoneMuteEnabled. -
Habilite ou desabilite a visibilidade da senha usando
setPasswordEnabled. -
Habilite ou desabilite o Play Protect usando
setPlayProtect. -
Defina e obtenha espaço reservado de log usando
setReservedLogSpaceegetReservedLogSpace. -
Defina o formato de hora usando
setTimeFormatEnabled. -
Habilite ou desabilite sons de toque usando
setTouchSoundEnabled. -
Defina níveis de volume usando
setVolumeLevel. -
Habilite ou desabilite o menu Compartilhar seleção de texto usando
setShowTextEditorShareMenuEnabled. -
Desligue o dispositivo silenciosamente usando
silentShutDown. -
Defina um lançador padrão silenciosamente usando
setSilentDefaultLauncher. -
Obtenha o status de bloqueio de firmware usando
getFirmwareStatusLockEnabled. -
Atualize o firmware do processador seguro usando
spFirmwareUpgrade. -
Inicie uma atividade de um serviço em primeiro plano usando
startActivityFromForegroundService. -
Habilite ou desabilite o Modo Escuro usando
setDarkModeEnabled. -
Desperte a tela usando
wakeupScreen. -
Habilite ou desabilite som e vibração de carregamento usando
setChargingSoundAndVibrationEnabled. -
Habilite ou desabilite o som de bloqueio de tela usando
setScreenLockSoundEnabled. -
Habilite ou desabilite o tile do Modo Ocioso usando
setIdleModeTileEnabled. -
Obtenha e defina o nome do host usando
getHostNameesetHostName. -
Habilite ou desabilite a acessibilidade do hotspot usando
setHotspotAccessibilityEnabledegetHotspotAccessibilityEnabled. -
Obtenha a verificação MD5 usando
getMD5Checksum. -
Vincule e desvincule o serviço do Sistema usando
bindServiceeunbindService.
isM60Device
public static boolean isM60Device()
Este método é usado para obter a orientação do dispositivo.
Retorna
Orientação do dispositivo, por exemplo retrato ou paisagem.
Exemplo
try {
// TODO: garantir que o serviço está vinculado antes de chamar APIs do SDK
Object result = sdk.isM60Device();
Log.d(TAG, "OK: isM60Device result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: isM60Device", e);
}
isM50Device
public static boolean isM50Device()
Este método é usado para obter a orientação do dispositivo.
Retorna
Orientação do dispositivo, por exemplo retrato ou paisagem.
Exemplo
try {
// TODO: garantir que o serviço está vinculado antes de chamar APIs do SDK
Object result = sdk.isM50Device();
Log.d(TAG, "OK: isM50Device result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: isM50Device", e);
}
isM100Device
public static boolean isM100Device()
Este método é usado para obter a orientação do dispositivo.
Retorna
Orientação do dispositivo, por exemplo retrato ou paisagem.
Exemplo
try {
// TODO: garantir que o serviço está vinculado antes de chamar APIs do SDK
Object result = sdk.isM100Device();
Log.d(TAG, "OK: isM100Device result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: isM100Device", e);
}
is7PayDevice
public static boolean is7PayDevice()
Este método é usado para obter a orientação do dispositivo.
Retorna
Orientação do dispositivo, por exemplo retrato ou paisagem.
Exemplo
try {
// TODO: garantir que o serviço está vinculado antes de chamar APIs do SDK
Object result = sdk.is7PayDevice();
Log.d(TAG, "OK: is7PayDevice result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: is7PayDevice", e);
}
isM51Device
public boolean isM51Device()
Este método é usado para obter a orientação do dispositivo.
Retorna
Orientação do dispositivo, por exemplo retrato ou paisagem.
Exemplo
try {
// TODO: garantir que o serviço está vinculado antes de chamar APIs do SDK
Object result = sdk.isM51Device();
Log.d(TAG, "OK: isM51Device result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: isM51Device", e);
}
bindService
public void bindService(android.content.Context context, ServiceConnectionCallback callback, java.lang.String accessToken)
Este método é usado para vincular o serviço para acessar as APIs do Sistema. Use este método para vincular ao serviço antes de usar as APIs do Sistema.
Parâmetros
- context – Contexto do aplicativo
Exemplo
try {
// TODO: garantir que o serviço está vinculado antes de chamar APIs do SDK
Object result = sdk.bindService(context, callback, "accessToken");
Log.d(TAG, "OK: bindService result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: bindService", e);
}
unbindService
public void unbindService(android.content.Context context)
Este método é usado para desvincular o serviço do aplicativo. Use este método para desvincular do serviço ao limpar recursos.
Parâmetros
- context – Contexto do aplicativo
Exemplo
try {
// TODO: garantir que o serviço está vinculado antes de chamar APIs do SDK
Object result = sdk.unbindService(context);
Log.d(TAG, "OK: unbindService result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: unbindService", e);
}
captureScreenShot
public boolean captureScreenShot(java.lang.String fileName)
Este método é usado para capturar uma captura de tela. A captura de tela será armazenada no local "/sdcard/elo/screenshot", e a mensagem de retorno também contém o caminho da captura de tela.
Parâmetros
- fileName – Um nome de arquivo em formato PNG, por exemplo "screenshot.png".
Retorna
true se a captura de tela for capturada com sucesso, false caso contrário.
Exemplo
try {
// TODO: garantir que o serviço está vinculado antes de chamar APIs do SDK
Object result = sdk.captureScreenShot("fileName");
Log.d(TAG, "OK: captureScreenShot result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: captureScreenShot", e);
}
setAccessibilityService
public void setAccessibilityService(java.lang.String packageName, boolean enableAccessibilityService)
Este método é usado para habilitar ou desabilitar serviços de acessibilidade.
Exemplo
try {
// TODO: garantir que o serviço está vinculado antes de chamar APIs do SDK
Object result = sdk.setAccessibilityService("packageName", true);
Log.d(TAG, "OK: setAccessibilityService result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: setAccessibilityService", e);
}
setMultiClientImeEnabled
public boolean setMultiClientImeEnabled(boolean enable, boolean reboot)
Este método é usado para habilitar ou desabilitar IME Multi-Cliente. Após a aplicação, o dispositivo reiniciará para refletir as mudanças.
Parâmetros
- enable – Se deseja habilitar ou desabilitar o recurso.
Exemplo
try {
// TODO: garantir que o serviço está vinculado antes de chamar APIs do SDK
Object result = sdk.setMultiClientImeEnabled(true, true);
Log.d(TAG, "OK: setMultiClientImeEnabled result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: setMultiClientImeEnabled", e);
}
setWifiScanning
public void setWifiScanning(boolean enable)
Este método é usado para habilitar ou desabilitar a varredura de WiFi.
Parâmetros
- enable – Se deseja habilitar ou desabilitar a varredura de WiFi.
Exemplo
try {
// TODO: garantir que o serviço está vinculado antes de chamar APIs do SDK
Object result = sdk.setWifiScanning(true);
Log.d(TAG, "OK: setWifiScanning result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: setWifiScanning", e);
}
setBluetoothScanning
public void setBluetoothScanning(boolean enable)
Este método é usado para habilitar ou desabilitar a varredura de Bluetooth.
Parâmetros
- enable – Se deseja habilitar ou desabilitar a varredura de Bluetooth.
Exemplo
try {
// TODO: garantir que o serviço está vinculado antes de chamar APIs do SDK
Object result = sdk.setBluetoothScanning(true);
Log.d(TAG, "OK: setBluetoothScanning result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: setBluetoothScanning", e);
}
setKeyListener
public boolean setKeyListener(java.lang.String packageName, java.lang.String receiverName, java.util.ArrayList<java.lang.Integer> keys, java.util.ArrayList<java.lang.Boolean> intercept)
Este método é usado para registrar um ouvinte de eventos de tecla que pode ser executado em um thread de fundo.
Parâmetros
- packageName – Nome do pacote ao qual o componente do ouvinte de tecla pertence.
Exemplo
try {
// TODO: garantir que o serviço está vinculado antes de chamar APIs do SDK
Object result = sdk.setKeyListener("packageName", "receiverName", 0, 0);
Log.d(TAG, "OK: setKeyListener result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: setKeyListener", e);
}
getMultiClientImeEnabled
public boolean getMultiClientImeEnabled()
Este método é usado para obter o estado habilitado do IME Multi-Cliente.
Exemplo
try {
// TODO: garantir que o serviço está vinculado antes de chamar APIs do SDK
Object result = sdk.getMultiClientImeEnabled();
Log.d(TAG, "OK: getMultiClientImeEnabled result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: getMultiClientImeEnabled", e);
}
setDpi
public boolean setDpi(int DPI)
Este método é usado para definir a DPI da tela. Um reinício é necessário para que a alteração tenha efeito.
Parâmetros
- DPI – Valor inteiro para densidade de tela (160, 240, 320, 480 ou 640).
Exemplo
try {
// TODO: garantir que o serviço está vinculado antes de chamar APIs do SDK
Object result = sdk.setDpi(0);
Log.d(TAG, "OK: setDpi result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: setDpi", e);
}
setCFDDpi
public boolean setCFDDpi(int DPI)
Este método é usado para definir a DPI do display externo.
Parâmetros
- DPI – Valor inteiro para densidade de tela (160, 240, 320, 480 ou 640).
Exemplo
try {
// TODO: garantir que o serviço está vinculado antes de chamar APIs do SDK
Object result = sdk.setCFDDpi(0);
Log.d(TAG, "OK: setCFDDpi result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: setCFDDpi", e);
}
setScreenSize
public boolean setScreenSize(int width, int height)
Este método é usado para definir a resolução da tela.
Parâmetros
- width – Largura da tela em pixels.
- height – Altura da tela em pixels.
Exemplo
try {
// TODO: garantir que o serviço está vinculado antes de chamar APIs do SDK
Object result = sdk.setScreenSize(0, 0);
Log.d(TAG, "OK: setScreenSize result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: setScreenSize", e);
}
setDisplaySize
public boolean setDisplaySize(java.lang.String size)
Este método é usado para definir o tamanho da tela.
Parâmetros
- size – Valor de string representando o tamanho da tela.
Exemplo
try {
// TODO: garantir que o serviço está vinculado antes de chamar APIs do SDK
Object result = sdk.setDisplaySize("size");
Log.d(TAG, "OK: setDisplaySize result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: setDisplaySize", e);
}
setFontSize
public boolean setFontSize(java.lang.String size)
Este método é usado para definir o tamanho da fonte.
Parâmetros
- size – Valor de string representando o tamanho da fonte.
Exemplo
try {
// TODO: garantir que o serviço está vinculado antes de chamar APIs do SDK
Object result = sdk.setFontSize("size");
Log.d(TAG, "OK: setFontSize result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: setFontSize", e);
}
setSmallestPixelWidth
public boolean setSmallestPixelWidth(int smallestWidth)
Este método é usado para definir a menor largura de pixel mostrada nas Opções do Desenvolvedor.
Parâmetros
- smallestWidth – Valor inteiro para a menor largura em pixels.
Exemplo
try {
// TODO: garantir que o serviço está vinculado antes de chamar APIs do SDK
Object result = sdk.setSmallestPixelWidth(0);
Log.d(TAG, "OK: setSmallestPixelWidth result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: setSmallestPixelWidth", e);
}
getSmallestPixelWidth
public int getSmallestPixelWidth()
Este método é usado para obter a menor largura de pixel mostrada nas Opções do Desenvolvedor.
Exemplo
try {
// TODO: garantir que o serviço está vinculado antes de chamar APIs do SDK
Object result = sdk.getSmallestPixelWidth();
Log.d(TAG, "OK: getSmallestPixelWidth result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: getSmallestPixelWidth", e);
}
setSilentDefaultLauncher
public boolean setSilentDefaultLauncher(java.lang.String packageName)
Este método é usado para definir silenciosamente o aplicativo lançador padrão.
Parâmetros
- packageName – Nome do pacote do aplicativo lançador.
Retorna
true se o lançador padrão for definido com sucesso, false caso contrário.
Exemplo
try {
// TODO: garantir que o serviço está vinculado antes de chamar APIs do SDK
Object result = sdk.setSilentDefaultLauncher("packageName");
Log.d(TAG, "OK: setSilentDefaultLauncher result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: setSilentDefaultLauncher", e);
}
clearAppCacheUserData
public boolean clearAppCacheUserData(java.lang.String packageNames)
Este método é usado para limpar o cache e os dados do usuário das aplicações especificadas.
Parâmetros
- packageNames – Lista de nomes de pacotes separadas por vírgula.
Retorna
true se o cache e os dados do usuário forem limpos com sucesso, false caso contrário.
Exemplo
try {
// TODO: garantir que o serviço está vinculado antes de chamar APIs do SDKPlease report any broken links by emailing support@elotouch.com and include a link to the knowledge article