As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Conceitos básicos

Instalar a biblioteca

Para adicionar a biblioteca de transmissão do Amazon IVS para Android a seu ambiente de desenvolvimento do Android, adicione a biblioteca ao seu arquivo build.gradle do módulo, conforme mostrado aqui (para a versão mais recente do SDK de transmissão do Amazon IVS):

repositories {
    mavenCentral()
}
 
dependencies {
     implementation 'com.amazonaws:ivs-broadcast:1.14.1'
}

Como alternativa, para instalar o SDK manualmente, baixe a versão mais recente neste local:

Criar listener de eventos

A configuração de um listener de eventos permite receber atualizações de estado, notificações de alteração de dispositivo, erros e informações sobre áudio de sessão.

BroadcastSession.Listener broadcastListener = 
          new BroadcastSession.Listener() {
    @Override
    public void onStateChanged(@NonNull BroadcastSession.State state) {
        Log.d(TAG, "State=" + state);
    }

    @Override
    public void onError(@NonNull BroadcastException exception) {
        Log.e(TAG, "Exception: " + exception);
    }
};

Solicitar permissões

Sua aplicação deverá solicitar permissão para acessar a câmera e o microfone do usuário. (Isso não é específico do Amazon IVS; é necessário para qualquer aplicação que precise acessar câmeras e microfones.)

Aqui, verificamos se o usuário já concedeu permissões e, caso contrário, nós as solicitamos:

final String[] requiredPermissions =
         { Manifest.permission.CAMERA, Manifest.permission.RECORD_AUDIO };

for (String permission : requiredPermissions) {
    if (ContextCompat.checkSelfPermission(this, permission) 
                != PackageManager.PERMISSION_GRANTED) {
        // If any permissions are missing we want to just request them all.
        ActivityCompat.requestPermissions(this, requiredPermissions, 0x100);
        break;
    }
}

Aqui, recebemos a resposta do usuário:

@Override
public void onRequestPermissionsResult(int requestCode, 
                                      @NonNull String[] permissions,
                                      @NonNull int[] grantResults) {
    super.onRequestPermissionsResult(requestCode,
               permissions, grantResults);
    if (requestCode == 0x100) {
        for (int result : grantResults) {
            if (result == PackageManager.PERMISSION_DENIED) {
                return;
            }
        }
        setupBroadcastSession();
    }
}

Criar a sessão de transmissão

A interface da transmissão é com.amazonaws.ivs.broadcast.BroadcastSession. Inicialize-a com uma predefinição, conforme mostrado abaixo. Se houver algum erro durante a inicialização (como uma falha na configuração de um codec), o BroadcastListener receberá uma mensagem de erro e broadcastSession.isReady será false.

Importante: todas as chamadas para o Amazon IVS Broadcast SDK for Android deverão ser feitas no thread em que o SDK está instanciado. Uma chamada de um thread diferente fará com que o SDK emita um erro fatal e interrompa a transmissão.

// Create a broadcast-session instance and sign up to receive broadcast
// events and errors.
Context ctx = getApplicationContext();
broadcastSession = new BroadcastSession(ctx,
                       broadcastListener,
                       Presets.Configuration.STANDARD_PORTRAIT,
                       Presets.Devices.FRONT_CAMERA(ctx));

Também consulte Criar a sessão de transmissão (versão avançada).

Defina o ImagePreviewView para visualização

Caso você queira ver uma pré-visualização em um dispositivo de câmera ativo, adicione uma pré-visualização ImagePreviewView ao dispositivo para sua hierarquia de exibição.

// awaitDeviceChanges will fire on the main thread after all pending devices 
// attachments have been completed
broadcastSession.awaitDeviceChanges(() -> {
    for(Device device: session.listAttachedDevices()) {
        // Find the camera we attached earlier
        if(device.getDescriptor().type == Device.Descriptor.DeviceType.CAMERA) {
            LinearLayout previewHolder = findViewById(R.id.previewHolder);
            ImagePreviewView preview = ((ImageDevice)device).getPreviewView();
            preview.setLayoutParams(new LinearLayout.LayoutParams(
                    LinearLayout.LayoutParams.MATCH_PARENT,
                    LinearLayout.LayoutParams.MATCH_PARENT));
            previewHolder.addView(preview);
        }
    }
});

Iniciar uma transmissão

O nome de host que você recebe no campo de resposta ingestEndpoint do endpoint GetChannel precisa ser precedido de rtmps:// e ter /app anexado. O URL completo deve estar no seguinte formato: rtmps://{{ ingestEndpoint }}/app

broadcastSession.start(IVS_RTMPS_URL, IVS_STREAMKEY);

O SDK de Transmissão para Android oferece suporte somente à ingestão de RTMPS (e não à ingestão insegura de RTMP).

Interromper uma transmissão

broadcastSession.stop();

Lançar sessão de transmissão do Android

É necessário chamar o método broadcastSession.release() quando a sessão de transmissão não estiver mais em uso para liberar os recursos usados pela biblioteca.

@Override
protected void onDestroy() {
    super.onDestroy();
    previewHolder.removeAllViews();
    broadcastSession.release();
}