com.opentok.android.PublisherKit
com.opentok.android.Publisher
Todas as interfaces implementadas:
: Observer
classe pública Publisher estende PublisherKit
Usado para capturar um fluxo de áudio e vídeo do microfone e da câmera do dispositivo para uso em uma sessão do OpenTok. Crie uma instância do Publisher chamando o construtor do Publisher.
Quando a visualização de um Publisher sai da janela ativa, o objeto Publisher é destruído. Isso ocorre no caso de uma atividade que seja interrompida ou pausada.
Veja também:
: - Session.publish(PublisherKit publisher)
Resumo das classes aninhadas
Classes aninhadas
Modificador e Tipo
Classe
Descrição
static class
Publisher.Builder
Usado para construir um Publisher objeto.
static enum
Publisher.CameraCaptureFrameRate
Define valores para o frameRate parâmetro do
Publisher.Builder.frameRate(Publisher.CameraCaptureFrameRate frameRate) método.
static enum
Publisher.CameraCaptureResolution
Define valores para o resolution parâmetro do
Publisher.Builder.resolution(Publisher.CameraCaptureResolution resolution) método.
static interface
Publisher.CameraListener
Monitora quando a câmera utilizada pelo editor é alterada.
Classes/interfaces aninhadas herdadas da classe com.opentok.android.PublisherKit
PublisherKit.AudioLevelListener, PublisherKit.AudioStatsListener, PublisherKit.AudioTransformer, PublisherKit.CustomAudioTransformer, PublisherKit.CustomVideoTransformer, PublisherKit.DegradationPreference, PublisherKit.MediaLinkStatsListener, PublisherKit.MuteListener, PublisherKit.PreferredVideoCodecs, PublisherKit.PublisherAudioStats, PublisherKit.PublisherKitVideoType, PublisherKit.PublisherListener, PublisherKit.PublisherMediaLinkStats, PublisherKit.PublisherRtcStats, PublisherKit.PublisherRtcStatsReportListener, PublisherKit.PublisherVideoStats, PublisherKit.VideoBitratePreset, PublisherKit.VideoLayerStats, PublisherKit.VideoListener, PublisherKit.VideoStatsListener, PublisherKit.VideoTransformer
Resumo do campo
Campos
Modificador e Tipo
Campo
Descrição
protected Publisher.CameraCaptureFrameRate
cameraFrameRate
protected Publisher.CameraListener
cameraListener
protected Publisher.CameraCaptureResolution
cameraResolution
Campos herdados da classe com.opentok.android.PublisherKit
audioLevelListener, audioStatsListener, capturer, context, handler, mediaLinkStatsListener, muteListener, NETWORK_REASON_NETWORK_CONDITION_CHANGE, publisherListener, renderer, rtcStatsReportListener, VIDEO_REASON_CODEC_CHANGE, VIDEO_REASON_NONE, VIDEO_REASON_QUALITY, VIDEO_REASON_QUALITY_DEGRADATION_BANDWIDTH, VIDEO_REASON_QUALITY_DEGRADATION_CPU, VIDEO_REASON_QUALITY_DEGRADATION_OTHER, VIDEO_REASON_RESOLUTION_CHANGE, videoListener, videoStatsListener
Resumo do Construtor
Construtores
Modificador
Construtor
Descrição
protected
Publisher(Publisher.Builder builder)
Resumo do método
Todos os métodosMétodos de instânciaMétodos concretosMétodos obsoletos
Modificador e Tipo
Método
Descrição
void
cycleCamera()
Alterna entre as câmeras, caso haja várias câmeras no dispositivo.
int
getCameraId()
Obsoleto.
protected void
onCameraChanged(int newCameraId)
É chamado quando o editor altera a câmera ativa.
protected void
onCameraError(OpentokError error)
É acionado quando ocorre um erro ao acessar a câmera.
void
setCameraId(int cameraId)
Obsoleto.
void
setCameraListener(Publisher.CameraListener listener)
Define um Publisher.CameraListener objeto para monitorar quando a câmera utilizada pelo
editor for alterada.
void
setCameraTorch(boolean enable)
Define o modo preferencial da lanterna (tocha) da câmera.
void
setCameraZoomFactor(float cameraZoomFactor)
O fator de zoom (proporção) preferencial para a câmera.
void
startPreview()
Obsoleto.
void
swapCamera()
Obsoleto.
Métodos herdados da classe com.opentok.android.PublisherKit
destroy, finalize, getCapturer, getDegradationPreference, getMaxVideoBitrate, getName, getPublishAudio, getPublishCaptions, getPublisherVideoType, getPublishVideo, getRenderer, getRtcStatsReport, getSession, getStream, getTargetScalabilityMode, getVideoBitratePreset, getView, onAudioLevelUpdated, onError, onMuteForced, onPause, onRestart, onResume, onRtcStatsReport, onStop, onStreamCreated, onStreamDestroyed, setAudioLevelListener, setAudioStatsListener, setAudioTransformers, setCapturer, setDegradationPreference, setMaxVideoBitrate, setMediaLinkStatsListener, setMuteListener, setName, setPublishAudio, setPublishCaptions, setPublisherListener, setPublisherVideoType, setPublishVideo, setRenderer, setRtcStatsReportListener, setStyle, setTargetScalabilityMode, setVideoBitratePreset, setVideoListener, setVideoStatsListener, setVideoTransformers, update
Métodos herdados da classe java.lang.Objeto
clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Detalhes do campo
cameraFrameRate
protegido Publisher.CameraCaptureFrameRate cameraFrameRate
resolução da câmera
protegido Publisher.CameraCaptureResolution resolução da câmera
cameraListener
protegido Publisher.CameraListener cameraListener
Detalhes do construtor
Editora
protected Publisher(Publisher.Builder construtor)
Detalhes do método
setCameraListener
public void setCameraListener(Publisher.CameraListener ouvinte)
Define um Publisher.CameraListener objeto para monitorar quando a câmera utilizada pelo
editor for alterada.
Parâmetros:
: listener - O Publisher.CameraListener instância.
setCameraId
@Obsoleto public void setCameraId(int cameraId)
Obsoleto.
Define a câmera desejada. cameraId pode ser um valor entre 0
e android.hardware.Camera#getNumberOfCameras() - 1.
Quando a câmera utilizada pelo Editor muda, o
Publisher.CameraListener.onCameraChanged(Publisher publisher, int newCameraId)
o método é chamado.
Esse método está obsoleto. Você deve usar o novo cycleCamera() método para alternar
entre as câmeras, caso haja várias câmeras no dispositivo.
Parâmetros:
: cameraId - o ID da câmera que você deseja usar neste editor
setCameraTorch
public void setCameraTorch(boolean enable)
Define o modo preferencial de lanterna para a câmera. Observe que essa é uma preferência e pode não entrar em vigor se a câmera ativa não for compatível com a funcionalidade de lanterna (por exemplo, a câmera frontal normalmente não é compatível com a funcionalidade de lanterna).
Parâmetros:
: enable - O valor padrão é false. Passar true ou false
indica se o editor deve ativar ou desativar a luz da câmera
quando disponível.
setCameraZoomFactor
public void setCameraZoomFactor(float cameraZoomFactor)
O fator de zoom (proporção) preferencial para a câmera. Um valor de 1,0 representa a ausência de zoom (a visualização padrão). O valor varia de 0,5 até o fator de zoom máximo. Valores entre 0,5 e 1,0 representam a ultra-grande angular (zoom out) e valores entre 1,0 e o fator de zoom máximo representam o zoom in. O fator de zoom real aplicado é automaticamente limitado ao intervalo suportado pela configuração da câmera ativa — se a câmera não suportar ultra-grande-angular, fatores de zoom definidos abaixo de 1,0 não terão efeito e nenhum zoom será aplicado. Para valores acima do fator de zoom máximo suportado pela câmera, o fator de zoom será definido com o valor máximo. Se a câmera do editor estiver ativada, a consulta a essa propriedade retorna o fator de zoom atual; se a câmera do editor não estiver ativada, a consulta a essa propriedade retorna o fator de zoom preferencial.
Parâmetros:
: cameraZoomFactor - A definição dessa propriedade indica o nível de zoom desejado,
sendo que um valor de 1,0 representa a ausência de zoom (a visualização padrão).
cycleCamera
public void cycleCamera()
Alterna entre as câmeras, caso haja várias câmeras no dispositivo. Quando
a câmera utilizada pelo Editor muda, o
Publisher.CameraListener.onCameraChanged(Publisher publisher, int newCameraId)
o método é chamado.
trocarCâmera
@Obsoleto public void trocarCâmera()
Obsoleto.
Esse método está obsoleto. Você deve usar o novo cycleCamera() método para alternar
entre as câmeras, caso haja várias câmeras no dispositivo.
Se você estiver usando um capturador de vídeo personalizado, implemente o
BaseVideoCapturer.CaptureSwitch interface no objeto que estende
BaseVideoCapturer e implementar a
BaseVideoCapturer.CaptureSwitch.swapCamera(int cameraId) método para definir o comportamento
do Publisher.swapCamera() método.
getCameraId
@Obsoleto public int getCameraId()
Obsoleto.
Retorna o ID da câmera ativa no momento. Esse valor é 0 (para a
câmera traseira) ou 1 (para a câmera frontal). Se
setCameraId(int) nunca é chamada, o valor de retorno é 1 (para a
câmera frontal).
Esse método está obsoleto. Você deve usar o novo cycleCamera() método para alternar
entre as câmeras, caso haja várias câmeras no dispositivo.
onCameraChanged
protected void onCameraChanged(int newCameraId)
É chamado quando o editor altera a câmera ativa.
Se você estender a classe Publisher, poderá sobrescrever este método em vez do
onCameraChanged() método da interface Publisher.CameraListener
.
Parâmetros:
: newCameraId - O ID da nova câmera ativa.
onCameraError
protected void onCameraError(OpentokError erro)
É acionado quando ocorre um erro ao acessar a câmera.
Parâmetros:
: error - O erro.
startPreview
@Obsoleto public void iniciarPré-visualização()
Obsoleto.
A partir da versão 2.17.0, esse método não realiza nenhuma ação. Assim que o objeto Publisher é criado, o vídeo da câmera é exibido na visualização do Publisher. Essa alteração torna o comportamento consistente entre os SDKs de cliente do OpenTok.