// =============================================================================
// CONTROLE DE TELA ATIVA - WINDEV MOBILE (Android e iOS)
// =============================================================================

// Declaração de variáveis globais
gbTelaAtiva is boolean = False
gnTimerTela is int = 0

// =============================================================================
// FUNÇÃO: AtivarTelaPermanecer
// Descrição: Mantém a tela ligada impedindo o modo sleep
// Plataforma: Android e iOS
// =============================================================================
PROCEDURE AtivarTelaPermanecer()

IF InAndroidMode() THEN
// Para Android - usando FLAG_KEEP_SCREEN_ON
CallDLL32(“android.view.WindowManager$LayoutParams”, “FLAG_KEEP_SCREEN_ON”, 128)

```
// Aplicar a flag na janela atual
sJavaCode is string = [
Window window = getWindow();
window.addFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON);
]

AndroidExecuteCode(sJavaCode)

// Método alternativo usando PowerManager (requer permissão WAKE_LOCK)
sJavaCodePower is string = [
PowerManager powerManager = (PowerManager) getSystemService(Context.POWER_SERVICE);
PowerManager.WakeLock wakeLock = powerManager.newWakeLock(
PowerManager.SCREEN_DIM_WAKE_LOCK | PowerManager.ACQUIRE_CAUSES_WAKEUP,
"MyApp:MyWakeLockTag"
);
wakeLock.acquire();
]

// Descomente a linha abaixo se preferir usar PowerManager
// AndroidExecuteCode(sJavaCodePower)

gbTelaAtiva = True
Info("Tela configurada para permanecer ativa (Android)")
```

ELSE IF InIOSMode() THEN
// Para iOS - desabilitar idle timer
sObjCCode is string = [
[[UIApplication sharedApplication] setIdleTimerDisabled:YES];
]

```
iOSExecuteCode(sObjCCode)
gbTelaAtiva = True
Info("Tela configurada para permanecer ativa (iOS)")
```

ELSE
// Modo simulador ou outras plataformas
Info(“Funcionalidade disponível apenas em dispositivos móveis”)
END

// =============================================================================
// FUNÇÃO: DesativarTelaPermanecer
// Descrição: Restaura o comportamento normal da tela (permite sleep)
// Plataforma: Android e iOS
// =============================================================================
PROCEDURE DesativarTelaPermanecer()

IF InAndroidMode() THEN
// Para Android - remover FLAG_KEEP_SCREEN_ON
sJavaCode is string = [
Window window = getWindow();
window.clearFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON);
]

```
AndroidExecuteCode(sJavaCode)

// Se usando PowerManager, liberar o wake lock
sJavaCodePower is string = [
if (wakeLock != null && wakeLock.isHeld()) {
wakeLock.release();
}
]

// AndroidExecuteCode(sJavaCodePower)

gbTelaAtiva = False
Info("Tela restaurada ao comportamento normal (Android)")
```

ELSE IF InIOSMode() THEN
// Para iOS - reabilitar idle timer
sObjCCode is string = [
[[UIApplication sharedApplication] setIdleTimerDisabled:NO];
]

```
iOSExecuteCode(sObjCCode)
gbTelaAtiva = False
Info("Tela restaurada ao comportamento normal (iOS)")
```

END

// =============================================================================
// FUNÇÃO: AtivarTelaPorTempo
// Descrição: Mantém a tela ativa por um tempo determinado
// Parâmetros: nSegundos - Tempo em segundos para manter ativa
// =============================================================================
PROCEDURE AtivarTelaPorTempo(nSegundos is int)

// Ativar tela
AtivarTelaPermanecer()

// Configurar timer para desativar automaticamente
gnTimerTela = Timer(nSegundos * 1000, TimerDesativarTela)

Info(StringBuild(“Tela ficará ativa por %1 segundos”, nSegundos))

// =============================================================================
// FUNÇÃO: TimerDesativarTela
// Descrição: Função chamada pelo timer para desativar a tela
// =============================================================================
PROCEDURE TimerDesativarTela()

// Parar o timer
EndTimer(gnTimerTela)

// Desativar tela
DesativarTelaPermanecer()

Info(“Tempo expirado - Tela voltou ao comportamento normal”)

// =============================================================================
// FUNÇÃO: VerificarStatusTela
// Descrição: Retorna se a tela está configurada para permanecer ativa
// Retorno: boolean - True se ativa, False se normal
// =============================================================================
PROCEDURE VerificarStatusTela() : boolean

RESULT gbTelaAtiva

// =============================================================================
// EXEMPLO DE USO EM UM BOTÃO OU PROCESSO
// =============================================================================

// Exemplo 1: Ativar permanentemente
// AtivarTelaPermanecer()

// Exemplo 2: Ativar por 5 minutos (300 segundos)
// AtivarTelaPorTempo(300)

// Exemplo 3: Desativar manualmente
// DesativarTelaPermanecer()

// Exemplo 4: Verificar status atual
// IF VerificarStatusTela() THEN
// Info(“Tela está ativa”)
// ELSE
// Info(“Tela em modo normal”)
// END

// =============================================================================
// GERENCIAMENTO DURANTE UMA TAREFA ESPECÍFICA
// =============================================================================

// Exemplo de uso durante download/upload ou processamento longo
PROCEDURE ExecutarTarefaLonga()

// Ativar tela no início da tarefa
AtivarTelaPermanecer()

// Simular tarefa longa
FOR i = 1 TO 100
// Sua tarefa aqui (download, processamento, etc.)
ProgressBar(i, “Processando… “ + i + “%”)
Multitask(100) // Permite atualização da interface
END

// Desativar tela ao final da tarefa
DesativarTelaPermanecer()

Info(“Tarefa concluída!”)

// =============================================================================
// PERMISSÕES NECESSÁRIAS
// =============================================================================

// Para Android (adicionar no arquivo AndroidManifest.xml):
//

// Para iOS: Não requer permissões especiais

// =============================================================================
// NOTAS IMPORTANTES
// =============================================================================

// 1. Sempre desative a funcionalidade quando não precisar mais
// 2. Use com moderação para não impactar a bateria
// 3. Considere implementar um timeout automático
// 4. Teste em dispositivos reais, não apenas no simulador
// 5. Para Android, FLAG_KEEP_SCREEN_ON é preferível ao WAKE_LOCK
// 6. Para iOS, setIdleTimerDisabled é a abordagem padrão