Package software.amazon.awssdk.services.chime.model

Class EngineTranscribeSettings

java.lang.Object
software.amazon.awssdk.services.chime.model.EngineTranscribeSettings
All Implemented Interfaces:
Serializable, SdkPojo, ToCopyableBuilder<EngineTranscribeSettings.Builder,EngineTranscribeSettings>
@Generated("software.amazon.awssdk:codegen") public final class EngineTranscribeSettings extends Object implements SdkPojo, Serializable, ToCopyableBuilder<EngineTranscribeSettings.Builder,EngineTranscribeSettings>

Settings specific for Amazon Transcribe as the live transcription engine.

If you specify an invalid combination of parameters, a TranscriptFailed event will be sent with the contents of the BadRequestException generated by Amazon Transcribe. For more information on each parameter and which combinations are valid, refer to the StartStreamTranscription API in the Amazon Transcribe Developer Guide.

See Also:

  • Method Details

    • languageCode

      public final TranscribeLanguageCode languageCode()

      Specify the language code that represents the language spoken.

      If you're unsure of the language spoken in your audio, consider using IdentifyLanguage to enable automatic language identification.

      If the service returns an enum value that is not available in the current SDK version, languageCode will return TranscribeLanguageCode.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from languageCodeAsString().

      Returns:
      Specify the language code that represents the language spoken.

      If you're unsure of the language spoken in your audio, consider using IdentifyLanguage to enable automatic language identification.

      See Also:

    • languageCodeAsString

      public final String languageCodeAsString()

      Specify the language code that represents the language spoken.

      If you're unsure of the language spoken in your audio, consider using IdentifyLanguage to enable automatic language identification.

      If the service returns an enum value that is not available in the current SDK version, languageCode will return TranscribeLanguageCode.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from languageCodeAsString().

      Returns:
      Specify the language code that represents the language spoken.

      If you're unsure of the language spoken in your audio, consider using IdentifyLanguage to enable automatic language identification.

      See Also:

    • vocabularyFilterMethod

      public final TranscribeVocabularyFilterMethod vocabularyFilterMethod()

      Specify how you want your vocabulary filter applied to your transcript.

      To replace words with ***, choose mask.

      To delete words, choose remove.

      To flag words without changing them, choose tag.

      If the service returns an enum value that is not available in the current SDK version, vocabularyFilterMethod will return TranscribeVocabularyFilterMethod.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from vocabularyFilterMethodAsString().

      Returns:
      Specify how you want your vocabulary filter applied to your transcript.

      To replace words with ***, choose mask.

      To delete words, choose remove.

      To flag words without changing them, choose tag.

      See Also:

    • vocabularyFilterMethodAsString

      public final String vocabularyFilterMethodAsString()

      Specify how you want your vocabulary filter applied to your transcript.

      To replace words with ***, choose mask.

      To delete words, choose remove.

      To flag words without changing them, choose tag.

      If the service returns an enum value that is not available in the current SDK version, vocabularyFilterMethod will return TranscribeVocabularyFilterMethod.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from vocabularyFilterMethodAsString().

      Returns:
      Specify how you want your vocabulary filter applied to your transcript.

      To replace words with ***, choose mask.

      To delete words, choose remove.

      To flag words without changing them, choose tag.

      See Also:

    • vocabularyFilterName

      public final String vocabularyFilterName()

      Specify the name of the custom vocabulary filter that you want to use when processing your transcription. Note that vocabulary filter names are case sensitive.

      If you use Amazon Transcribe in multiple Regions, the vocabulary filter must be available in Amazon Transcribe in each Region.

      If you include IdentifyLanguage and want to use one or more vocabulary filters with your transcription, use the VocabularyFilterNames parameter instead.

      Returns:
      Specify the name of the custom vocabulary filter that you want to use when processing your transcription. Note that vocabulary filter names are case sensitive.

      If you use Amazon Transcribe in multiple Regions, the vocabulary filter must be available in Amazon Transcribe in each Region.

      If you include IdentifyLanguage and want to use one or more vocabulary filters with your transcription, use the VocabularyFilterNames parameter instead.

    • vocabularyName

      public final String vocabularyName()

      Specify the name of the custom vocabulary that you want to use when processing your transcription. Note that vocabulary names are case sensitive.

      If you use Amazon Transcribe multiple Regions, the vocabulary must be available in Amazon Transcribe in each Region.

      If you include IdentifyLanguage and want to use one or more custom vocabularies with your transcription, use the VocabularyNames parameter instead.

      Returns:
      Specify the name of the custom vocabulary that you want to use when processing your transcription. Note that vocabulary names are case sensitive.

      If you use Amazon Transcribe multiple Regions, the vocabulary must be available in Amazon Transcribe in each Region.

      If you include IdentifyLanguage and want to use one or more custom vocabularies with your transcription, use the VocabularyNames parameter instead.

    • region

      public final TranscribeRegion region()

      The AWS Region in which to use Amazon Transcribe.

      If you don't specify a Region, then the MediaRegion parameter of the CreateMeeting.html API will be used. However, if Amazon Transcribe is not available in the MediaRegion, then a TranscriptFailed event is sent.

      Use auto to use Amazon Transcribe in a Region near the meeting’s MediaRegion. For more information, refer to Choosing a transcription Region in the Amazon Chime SDK Developer Guide.

      If the service returns an enum value that is not available in the current SDK version, region will return TranscribeRegion.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from regionAsString().

      Returns:
      The AWS Region in which to use Amazon Transcribe.

      If you don't specify a Region, then the MediaRegion parameter of the CreateMeeting.html API will be used. However, if Amazon Transcribe is not available in the MediaRegion, then a TranscriptFailed event is sent.

      Use auto to use Amazon Transcribe in a Region near the meeting’s MediaRegion. For more information, refer to Choosing a transcription Region in the Amazon Chime SDK Developer Guide.

      See Also:

    • regionAsString

      public final String regionAsString()

      The AWS Region in which to use Amazon Transcribe.

      If you don't specify a Region, then the MediaRegion parameter of the CreateMeeting.html API will be used. However, if Amazon Transcribe is not available in the MediaRegion, then a TranscriptFailed event is sent.

      Use auto to use Amazon Transcribe in a Region near the meeting’s MediaRegion. For more information, refer to Choosing a transcription Region in the Amazon Chime SDK Developer Guide.

      If the service returns an enum value that is not available in the current SDK version, region will return TranscribeRegion.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from regionAsString().

      Returns:
      The AWS Region in which to use Amazon Transcribe.

      If you don't specify a Region, then the MediaRegion parameter of the CreateMeeting.html API will be used. However, if Amazon Transcribe is not available in the MediaRegion, then a TranscriptFailed event is sent.

      Use auto to use Amazon Transcribe in a Region near the meeting’s MediaRegion. For more information, refer to Choosing a transcription Region in the Amazon Chime SDK Developer Guide.

      See Also:

    • enablePartialResultsStabilization

      public final Boolean enablePartialResultsStabilization()

      Enables partial result stabilization for your transcription. Partial result stabilization can reduce latency in your output, but may impact accuracy.

      Returns:
      Enables partial result stabilization for your transcription. Partial result stabilization can reduce latency in your output, but may impact accuracy.

    • partialResultsStability

      public final TranscribePartialResultsStability partialResultsStability()

      Specify the level of stability to use when you enable partial results stabilization ( EnablePartialResultsStabilization).

      Low stability provides the highest accuracy. High stability transcribes faster, but with slightly lower accuracy.

      If the service returns an enum value that is not available in the current SDK version, partialResultsStability will return TranscribePartialResultsStability.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from partialResultsStabilityAsString().

      Returns:
      Specify the level of stability to use when you enable partial results stabilization ( EnablePartialResultsStabilization).

      Low stability provides the highest accuracy. High stability transcribes faster, but with slightly lower accuracy.

      See Also:

    • partialResultsStabilityAsString

      public final String partialResultsStabilityAsString()

      Specify the level of stability to use when you enable partial results stabilization ( EnablePartialResultsStabilization).

      Low stability provides the highest accuracy. High stability transcribes faster, but with slightly lower accuracy.

      If the service returns an enum value that is not available in the current SDK version, partialResultsStability will return TranscribePartialResultsStability.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from partialResultsStabilityAsString().

      Returns:
      Specify the level of stability to use when you enable partial results stabilization ( EnablePartialResultsStabilization).

      Low stability provides the highest accuracy. High stability transcribes faster, but with slightly lower accuracy.

      See Also:

    • contentIdentificationType

      public final TranscribeContentIdentificationType contentIdentificationType()

      Labels all personally identifiable information (PII) identified in your transcript. If you don't include PiiEntityTypes, all PII is identified.

      You can’t set ContentIdentificationType and ContentRedactionType.

      If the service returns an enum value that is not available in the current SDK version, contentIdentificationType will return TranscribeContentIdentificationType.UNKNOWN_TO_SDK_VERSION . The raw value returned by the service is available from contentIdentificationTypeAsString().

      Returns:
      Labels all personally identifiable information (PII) identified in your transcript. If you don't include PiiEntityTypes, all PII is identified.

      You can’t set ContentIdentificationType and ContentRedactionType.

      See Also:

    • contentIdentificationTypeAsString

      public final String contentIdentificationTypeAsString()

      Labels all personally identifiable information (PII) identified in your transcript. If you don't include PiiEntityTypes, all PII is identified.

      You can’t set ContentIdentificationType and ContentRedactionType.

      If the service returns an enum value that is not available in the current SDK version, contentIdentificationType will return TranscribeContentIdentificationType.UNKNOWN_TO_SDK_VERSION . The raw value returned by the service is available from contentIdentificationTypeAsString().

      Returns:
      Labels all personally identifiable information (PII) identified in your transcript. If you don't include PiiEntityTypes, all PII is identified.

      You can’t set ContentIdentificationType and ContentRedactionType.

      See Also:

    • contentRedactionType

      public final TranscribeContentRedactionType contentRedactionType()

      Content redaction is performed at the segment level. If you don't include PiiEntityTypes, all PII is redacted.

      You can’t set ContentIdentificationType and ContentRedactionType.

      If the service returns an enum value that is not available in the current SDK version, contentRedactionType will return TranscribeContentRedactionType.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from contentRedactionTypeAsString().

      Returns:
      Content redaction is performed at the segment level. If you don't include PiiEntityTypes, all PII is redacted.

      You can’t set ContentIdentificationType and ContentRedactionType.

      See Also:

    • contentRedactionTypeAsString

      public final String contentRedactionTypeAsString()

      Content redaction is performed at the segment level. If you don't include PiiEntityTypes, all PII is redacted.

      You can’t set ContentIdentificationType and ContentRedactionType.

      If the service returns an enum value that is not available in the current SDK version, contentRedactionType will return TranscribeContentRedactionType.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from contentRedactionTypeAsString().

      Returns:
      Content redaction is performed at the segment level. If you don't include PiiEntityTypes, all PII is redacted.

      You can’t set ContentIdentificationType and ContentRedactionType.

      See Also:

    • piiEntityTypes

      public final String piiEntityTypes()

      Specify which types of personally identifiable information (PII) you want to redact in your transcript. You can include as many types as you'd like, or you can select ALL.

      Values must be comma-separated and can include: ADDRESS, BANK_ACCOUNT_NUMBER, BANK_ROUTING, CREDIT_DEBIT_CVV, CREDIT_DEBIT_EXPIRY CREDIT_DEBIT_NUMBER, EMAIL,NAME, PHONE, PIN, SSN, or ALL.

      Note that if you include PiiEntityTypes, you must also include ContentIdentificationType or ContentRedactionType.

      If you include ContentRedactionType or ContentIdentificationType, but do not include PiiEntityTypes, all PII is redacted or identified.

      Returns:
      Specify which types of personally identifiable information (PII) you want to redact in your transcript. You can include as many types as you'd like, or you can select ALL.

      Values must be comma-separated and can include: ADDRESS, BANK_ACCOUNT_NUMBER, BANK_ROUTING, CREDIT_DEBIT_CVV, CREDIT_DEBIT_EXPIRY CREDIT_DEBIT_NUMBER, EMAIL,NAME, PHONE, PIN, SSN, or ALL.

      Note that if you include PiiEntityTypes, you must also include ContentIdentificationType or ContentRedactionType.

      If you include ContentRedactionType or ContentIdentificationType, but do not include PiiEntityTypes, all PII is redacted or identified.

    • languageModelName

      public final String languageModelName()

      Specify the name of the custom language model that you want to use when processing your transcription. Note that language model names are case sensitive.

      The language of the specified language model must match the language code. If the languages don't match, the custom language model isn't applied. There are no errors or warnings associated with a language mismatch.

      If you use Amazon Transcribe in multiple Regions, the custom language model must be available in Amazon Transcribe in each Region.

      Returns:
      Specify the name of the custom language model that you want to use when processing your transcription. Note that language model names are case sensitive.

      The language of the specified language model must match the language code. If the languages don't match, the custom language model isn't applied. There are no errors or warnings associated with a language mismatch.

      If you use Amazon Transcribe in multiple Regions, the custom language model must be available in Amazon Transcribe in each Region.

    • identifyLanguage

      public final Boolean identifyLanguage()

      Enables automatic language identification for your transcription.

      If you include IdentifyLanguage, you can optionally use LanguageOptions to include a list of language codes that you think may be present in your audio stream. Including language options can improve transcription accuracy.

      You can also use PreferredLanguage to include a preferred language. Doing so can help Amazon Transcribe identify the language faster.

      You must include either LanguageCode or IdentifyLanguage.

      Language identification can't be combined with custom language models or redaction.

      Returns:
      Enables automatic language identification for your transcription.

      If you include IdentifyLanguage, you can optionally use LanguageOptions to include a list of language codes that you think may be present in your audio stream. Including language options can improve transcription accuracy.

      You can also use PreferredLanguage to include a preferred language. Doing so can help Amazon Transcribe identify the language faster.

      You must include either LanguageCode or IdentifyLanguage.

      Language identification can't be combined with custom language models or redaction.

    • languageOptions

      public final String languageOptions()

      Specify two or more language codes that represent the languages you think may be present in your media; including more than five is not recommended. If you're unsure what languages are present, do not include this parameter.

      Including language options can improve the accuracy of language identification.

      If you include LanguageOptions, you must also include IdentifyLanguage.

      You can only include one language dialect per language. For example, you cannot include en-US and en-AU.

      Returns:
      Specify two or more language codes that represent the languages you think may be present in your media; including more than five is not recommended. If you're unsure what languages are present, do not include this parameter.

      Including language options can improve the accuracy of language identification.

      If you include LanguageOptions, you must also include IdentifyLanguage.

      You can only include one language dialect per language. For example, you cannot include en-US and en-AU.

    • preferredLanguage

      public final TranscribeLanguageCode preferredLanguage()

      Specify a preferred language from the subset of languages codes you specified in LanguageOptions.

      You can only use this parameter if you include IdentifyLanguage and LanguageOptions.

      If the service returns an enum value that is not available in the current SDK version, preferredLanguage will return TranscribeLanguageCode.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from preferredLanguageAsString().

      Returns:
      Specify a preferred language from the subset of languages codes you specified in LanguageOptions.

      You can only use this parameter if you include IdentifyLanguage and LanguageOptions.

      See Also:

    • preferredLanguageAsString

      public final String preferredLanguageAsString()

      Specify a preferred language from the subset of languages codes you specified in LanguageOptions.

      You can only use this parameter if you include IdentifyLanguage and LanguageOptions.

      If the service returns an enum value that is not available in the current SDK version, preferredLanguage will return TranscribeLanguageCode.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from preferredLanguageAsString().

      Returns:
      Specify a preferred language from the subset of languages codes you specified in LanguageOptions.

      You can only use this parameter if you include IdentifyLanguage and LanguageOptions.

      See Also:

    • vocabularyNames

      public final String vocabularyNames()

      Specify the names of the custom vocabularies that you want to use when processing your transcription. Note that vocabulary names are case sensitive.

      If you use Amazon Transcribe in multiple Regions, the vocabulary must be available in Amazon Transcribe in each Region.

      If you don't include IdentifyLanguage and want to use a custom vocabulary with your transcription, use the VocabularyName parameter instead.

      Returns:
      Specify the names of the custom vocabularies that you want to use when processing your transcription. Note that vocabulary names are case sensitive.

      If you use Amazon Transcribe in multiple Regions, the vocabulary must be available in Amazon Transcribe in each Region.

      If you don't include IdentifyLanguage and want to use a custom vocabulary with your transcription, use the VocabularyName parameter instead.

    • vocabularyFilterNames

      public final String vocabularyFilterNames()

      Specify the names of the custom vocabulary filters that you want to use when processing your transcription. Note that vocabulary filter names are case sensitive.

      If you use Amazon Transcribe in multiple Regions, the vocabulary filter must be available in Amazon Transcribe in each Region.

      If you're not including IdentifyLanguage and want to use a custom vocabulary filter with your transcription, use the VocabularyFilterName parameter instead.

      Returns:
      Specify the names of the custom vocabulary filters that you want to use when processing your transcription. Note that vocabulary filter names are case sensitive.

      If you use Amazon Transcribe in multiple Regions, the vocabulary filter must be available in Amazon Transcribe in each Region.

      If you're not including IdentifyLanguage and want to use a custom vocabulary filter with your transcription, use the VocabularyFilterName parameter instead.

    • toBuilder

      public EngineTranscribeSettings.Builder toBuilder()
      Description copied from interface: ToCopyableBuilder
      Take this object and create a builder that contains all of the current property values of this object.
      Specified by:
      toBuilder in interface ToCopyableBuilder<EngineTranscribeSettings.Builder,EngineTranscribeSettings>
      Returns:
      a builder for type T

    • builder

      public static EngineTranscribeSettings.Builder builder()

    • serializableBuilderClass

      public static Class<? extends EngineTranscribeSettings.Builder> serializableBuilderClass()

    • hashCode

      public final int hashCode()
      Overrides:
      hashCode in class Object

    • equals

      public final boolean equals(Object obj)
      Overrides:
      equals in class Object

    • equalsBySdkFields

      public final boolean equalsBySdkFields(Object obj)
      Description copied from interface: SdkPojo
      Indicates whether some other object is "equal to" this one by SDK fields. An SDK field is a modeled, non-inherited field in an SdkPojo class, and is generated based on a service model.

      If an SdkPojo class does not have any inherited fields, equalsBySdkFields and equals are essentially the same.

      Specified by:
      equalsBySdkFields in interface SdkPojo
      Parameters:
      obj - the object to be compared with
      Returns:
      true if the other object equals to this object by sdk fields, false otherwise.

    • toString

      public final String toString()
      Returns a string representation of this object. This is useful for testing and debugging. Sensitive data will be redacted from this string using a placeholder value.
      Overrides:
      toString in class Object

    • getValueForField

      public final <T> Optional<T> getValueForField(String fieldName, Class<T> clazz)

    • sdkFields

      public final List<SdkField<?>> sdkFields()
      Specified by:
      sdkFields in interface SdkPojo
      Returns:
      List of SdkField in this POJO. May be empty list but should never be null.