ssml split下載ssml split源代碼下載

ssml split

Ai源碼

1.0.0

下載

SSML拆分

將SSML字符串分解為批量的AWS Polly polly polly它們的文本對語言API可以消費。

特徵

將您的大SSML分成批處理AWS Polly，Google的文字到Speech API可以消費。
通過配置hardLimit ，請確保您保持低於API字符的限制。
創建最小可能的批處理大小，以將您的請求限制在文本中。
將在最近的文本中拆分文本. , ;或空間。可以配置。
通過刪除新線條，過多的白色空間和空標籤來消毒您的SSML，從而減少了使用的字符。
使用TypeScript，以便您可以享受隨附的類型安全和文檔。

基於@oleglegun的Polly-SSML-Split

文件

安裝 - 遍歷如何安裝SSML拆分。
用法 - 閱讀SSML拆分如何與可用選項一起使用。
建議的選項 - 使用這些選項快速開始。
做出貢獻 - 熟悉如何回到SSML分裂
行為準則 - 遵循這些存儲庫規則，成為一個好公民

安裝

安裝包裹：

npm install ssml-split --save

用法

導入包並設置選項。使用.split()方法拆分您的SSML字符串。您可以調整softLimit ，以查看對您有用的東西。我建議您將hardLimit保持在相應API的限制限制：

 import SSMLSplit from 'ssml-split' ;

const ssmlSplit = new SSMLSplit ( {
  // The service you are using: "google" or "aws"
  synthesizer : 'google' ,
  // Finds a possible split moment starting from 4000 characters
  softLimit : 4000 ,
  // Google Text to Speech limitation
  hardLimit : 5000 ,
  // Allow to split large paragraphs, set to false to keep your <p></p> intact
  breakParagraphsAboveHardLimit : true
} ) ;

const batches = ssmlSplit . split ( '<speak>your long ssml here</speak>' ) ;

選項	類型	預設	描述
`synthesizer`	`string`	`aws`	設置您使用的合成器。當您使用`breakParagraphsAboveHardLimit`時很有用。它允許庫確定正確的斷裂長度，因為每個合成器服務都不同。
`softLimit`	`number`	`1500`	該腳本將開始嘗試以多個部分分解您的SSML的字符數量。您可以調整此數字以查看對您有用的方法。
`hardLimit`	`number`	`3000`	每個SSML零件的最大尺寸應保持在低於腳本的字符數量。如果任何批處理大小都高於此，則腳本將出錯。此硬限制是您正在使用的AWS或Google API的字符限制。
`breakParagraphsAboveHardLimit`	`boolean`	`false`	設置為`true` ，以允許腳本通過刪除`<p>`並用<break `</p>` `<break strength="x-strong" />` （對於`aws` ）或`<break strength="x-weak" />` （用於`google` ）來打破大段落。這會導致相同的暫停。需要設置選項`synthesizer` 。
`extraSplitChars`	`string`	`,;.`	可以用作純文本的拆分標記的字符。

關於：合成器

通過使用選項synthesizer: 'google'庫將包括計數SSML標籤字符，以確定最佳的拆分時刻。這使圖書館還可以使用Google的文本到語音API。

例如： <speak>some text</speak>

默認行為將其視為9個字符，這對AWS Polly很好，但對於Google的文字到語音API來說不是。

使用synthesizer: 'google'將被視為31個字符，就像Google的文字對語音API的文本一樣。

這應該阻止您在使用Google的文本對語音API時看到此錯誤：

INVALID_ARGUMENT: 5000 characters limit exceeded.

關於：BreakParagraphaphabophSaboveHardlimit

通過添加選項breakParagraphsAboveHardLimit: true您允許腳本通過刪除並用<break strength="x-strong" /> for aws或<break strength="x-weak" /> for 來分解大段落。這會導致相同的暫停。這允許圖書館正確拆分大段落。

在使用Google的文本對語音API時，使用此選項將導致您的用法再增加20個字符。

如果您使用大段落，並且不使用此選項，那麼您可能會遇到諸如SSML tag appeared to be too long 。

當您的SSML長度超過hardLimit時，建議使用此選項。

建議的選項

AWS

 new SSMLSplit ( {
  synthesizer : 'aws' ,
  softLimit : 2000 ,
  hardLimit : 3000 , // AWS Polly limitation
  breakParagraphsAboveHardLimit : true , // optional, but recommended when you have large <p>'s
} )

Google

 new SSMLSplit ( {
  synthesizer : 'google' ,
  softLimit : 4000 ,
  hardLimit : 5000 , // Google Text to Speech API limitation
  breakParagraphsAboveHardLimit : true , // optional, but recommended when you have large <p>'s
} )

關於

@oleglegun庫的Polly-SSML-SPLIT已經正確處理了AWS Polly的SSML分裂，但無法正常工作以使Google的文本進行語音。因此，我只是修改了包裹以滿足我的需求。

與`polly-ssml-split`相比，變化：

添加了synthesizer選項以根據完整的SSML標籤計數字符，而不僅僅是隨附的文本字符。如果您使用Google的文本到語音API，則需要。
重寫庫以使用TypeScript，因此您可以在打字稿項目中獲得正確的類型檢查。
刪除了.configure方法，然後使用類構造方法將其用於IT。
添加了breakParagraphsAboveHardLimit選項，通過刪除並用<break strength="x-strong" /> for aws或<break strength="x-weak" />為Google替換< /  >，以分解大段落。這會導致相同的暫停。這允許庫正確拆分段落，並將文本較少的批次發送給語音API。
使用開玩笑添加了更多測試。