Package org.kurento.client

Class RecorderEndpoint.Builder

java.lang.Object
org.kurento.client.AbstractBuilder<RecorderEndpoint>
org.kurento.client.RecorderEndpoint.Builder
Enclosing interface:
RecorderEndpoint
public static class RecorderEndpoint.Builder extends AbstractBuilder<RecorderEndpoint>

  • Constructor Details

    • Builder

      public Builder(MediaPipeline mediaPipeline, String uri)
      Creates a Builder for RecorderEndpoint

  • Method Details

    • withProperties

      public RecorderEndpoint.Builder withProperties(Properties properties)
      Overrides:
      withProperties in class AbstractBuilder<RecorderEndpoint>

    • with

      public RecorderEndpoint.Builder with(String name, Object value)
      Overrides:
      with in class AbstractBuilder<RecorderEndpoint>

    • withMediaProfile

      public RecorderEndpoint.Builder withMediaProfile(MediaProfileSpecType mediaProfile)
      Sets a value for mediaProfile in Builder for RecorderEndpoint.
      Parameters:
      mediaProfile - Selects the media format used for recording.

      The media profile allows you to specify which codecs and media container will be used for the recordings. This is currently the only way available to tell Kurento about which codecs should be used.

      Watch out for these important remarks:

      • If the format of incoming media differs from the recording profile, media will need to be transcoded. Transcoding always incurs in noticeable CPU load, so it is always good trying to avoid it. For instance, if a VP8-encoded video (from WebRTC) is recorded with an MP4 recording profile (which means H.264 encoding), the video needs to be transcoded from VP8 to H.264. On the other hand, recording with the WEBM profile would allow to store the video as-is with its VP8 encoding.
      • If you intend to record audio-only or video-only media, select the appropriate _AUDIO_ONLY or _VIDEO_ONLY profile. For example, to record a WebRTC screen capture (as obtained from a web browser's call to MediaDevices.getDisplayMedia()), choose WEBM_VIDEO_ONLY instead of just WEBM.

    • stopOnEndOfStream

      public RecorderEndpoint.Builder stopOnEndOfStream()
      Forces the recorder endpoint to finish processing data when an End Of Stream (EOS) is detected in the stream