Documentation

Nôl Data Trawssgrifiad

Nôl data o drosysgrifiadau ar y gweill neu wedi'u cwblhau

Sesiynau Trawssgrifiad

Monitro a rheoli cyflwr trosglwyddo gyda sesiynau

Cyfieithu

Cyfieithu testun wedi' i drosi i iaith arall

Trosysgrifo Sain o URL

Trosysgrifo iaith o sain wedi'i recordio'n barod mewn URL i destun plaen

Tocynnau Dilysiant Ochr y Cleient

Creu tocyn dilysiant dros dro ar gyfer ceisiadau ochr y cleient

Cais a Ymateb Trawssgrifiad

Dewisiadau cyffredin cais a chwynion am bob gweithrediad trosglwyddo

Trosysgrifo a Chyflwyno Sesiwn PolyglotName

Creu sesiwn y gellir ei ddefnyddio i ddarlledu trosglwyddiad byw drwy gyswllt cyhoeddus rhannadwy

Trosysgrifo o'r Meicroffon neu LiveStream

Pori Dogfennaeth
Trosysgrifo siarad byw o microffon neu llif byw. Cyfuno â Polyglot i greu cysylltiad cyhoeddus rhannadwy ar gyfer y trosysgrifiad y gall defnyddwyr ei ddarllen mewn unrhyw iaith.
I drosi o feicroffon rhaid i ni anfon pecynnau llif data sain yn gyson i'r API VocalStack.
JavaScript
import { LiveTranscription } from '@vocalstack/js-sdk'; const sdk = new LiveTranscription({ apiKey: 'YOUR-API-KEY' }); const stream = await sdk.connect({ // Optional: Integrate this stream with a Polyglot session polyglot_id: 'YOUR-POLYGLOT-SESSION-ID', // Optional: language of the speech spoken // (this can be used to improve the transcription accuracy) language: 'en', // Optional: Translate the transcription to these languages translations: ['de'], // Optional: Stop the stream after this many seconds of inactivity timeout_period_s: 60, // Optional: Hard stop the stream after this many seconds max_duration_s: 300, }); // Start the stream stream.start(); // Get audio data from a microphone and send it to the stream // stream.sendBuffer(buffer); // *** This is a placeholder for the actual implementation *** // Manually stop the stream (in this example, after 60 seconds) // If max_duration_s is set, stopping the stream is optional setTimeout(() => stream.stop(), 60000); // Listen for stream transcription data stream.onData((response) => { const { status, data } = response; console.log(status); // 'waiting', 'processing', 'done', 'stopping' or 'error' if (data) { console.log(data.timeline); // an object with the transcription timeline } if (status === 'done') { console.log(data.summary); // a summary of the transcription console.log(data.keywords); // an array of keywords console.log(data.paragraphs); // the entire transcription in paragraph form } });
Bydd cael data'r llif sain yn amrywio yn seiliedig ar yr amgylchedd lle rydych am weithredu'r weithred trosglwyddo. Dyma rai enghreifftiau o sut y gallech wneud hyn:
Yn NextJS dylech osod pecyn sy'n gallu nôl data sain o'ch dyfais, y gallwch yna ei anfon ymlaen i'r API VocalStack. Dyma enghraifft:
JavaScript
const mic = require('mic'); // Create a new instance of the microphone utility const micInstance = mic(); // Get the audio input stream const micStream = micInstance.getAudioStream(); // Capture the audio data from the microphone micStream.on('data', (data) => { stream.sendBuffer(data); // send the buffer data to the VocalStack API }); // Start capturing audio from the microphone micInstance.start();
Ar y porwr gwe efallai hoffech ddefnyddio'r MediaRecorderName API fel y gwelir yn yr enghraifft ganlynol. (Gall fod yn syniad da hefyd i ddefnyddio pecyn fel recordrtc which improves browser compatibility)
JavaScript
// Request access to the microphone const mediaStream = await navigator.mediaDevices.getUserMedia({ audio: true }); // Create a MediaRecorder instance to capture audio data const mediaRecorder = new MediaRecorder(mediaStream); // Event handler to process audio data packets mediaRecorder.ondataavailable = async (event) => { const blob = event.data; // this is the audio packet (Blob) const buffer = await blob.arrayBuffer(); // convert the Blob to a Buffer stream.sendBuffer(buffer); // send the buffer data to the VocalStack API }; // Start capturing audio, and send it to the stream every second mediaRecorder.start(1000);
Noder y bydd angen i chi ddefnyddio tocyn awdurdodi er mwyn cael mynediad i'r API VocalStack ar ddibynnyddion gwe:
Tocynnau Dilysiant Ochr y Cleient
Creu tocyn dilysiant dros dro ar gyfer ceisiadau ochr y cleient. Gweithredu ceisiadau API yn ddiogel mewn porwyr gwe heb arddangos eich allweddi API.
Gall API VocalStack gael ei ddefnyddio i drosi unrhyw URL LiveStream HLS, gan gynnwys ffynonellau fel Youtube Live, Facebook Live, a Twitch. Noder bod rhaid i' r URL llif fod yn. .m3u8 estyniad ffeil sy'n cynrychioli ffeil chwarae HLS (Llifogi Byw HTTP) dilys.
JavaScript
import { LiveTranscription } from '@vocalstack/js-sdk'; const sdk = new LiveTranscription({ apiKey: 'YOUR-API-KEY' }); const stream = await sdk.connect({ // must be a valid HLS streaming protocol livestream_url: 'http://a.files.bbci.co.uk/media/live/manifesto/audio/simulcast/hls/nonuk/sbr_low/ak/bbc_world_service.m3u8', // The rest of these options are the same as for microphone live transcriptons }); stream.start(); stream.onData((response) => { // The response object is the same as the one // returned by microphone transcriptions });
Mae integreiddio traethodau byw gyda Polyglot mor syml â ychwanegu _Id Aml-iaith dewis i'r cais trosglwyddo, fel y dangosir yn yr enghreifftiau uchod.
Polyglot yn creu cyswllt cyhoeddus rhannadwy sy' n gysylltiedig â' ch trosysgrifiadau (gellir gwarchod y cyswllt gyda chyfrinair):
  • Gall defnyddwyr ddarllen eich trosglwyddiad yn real- time gan ddefnyddio' r cyswllt.
  • Gall defnyddwyr ddewis yr iaith i ddarllen y trosglwyddiad ynddi yn real- time.
  • Gall defnyddwyr ddarllen eich trosysgrifiad yn ddiweddarach, a phob trosysgrifiad arall wedi ei gydgysylltu â' ch sesiwn Polyglot penodol.
Mae croeso i chi ddefnyddio API VocalStack a chymhwyso eich rhyngwyneb defnyddiwr label coch eich hun yn lle defnyddio'r un a ddarperir gan VocalStack. Byddem wrth ein bodd yn clywed amdano os ydych yn gwneud, felly gallwn ddysgu am sut i wneud ein cynnyrch yn well!
Dysgu mwy am sut mae Polyglot yn gweithio yn VocalStack.
Trosysgrifo a Chyflwyno Sesiwn PolyglotName
Creu sesiwn y gellir ei ddefnyddio i ddarlledu trosglwyddiad byw drwy gyswllt cyhoeddus rhannadwy. Gall defnyddwyr ddarllen trosysgrifiadau byw yn eu hoff iaith, a hyd yn oed trosysgrifiadau o'r gorffennol pan fo'ch sesiwn yn anweithredol.
Nôl Data Trawssgrifiad
Nôl data o drosysgrifiadau ar y gweill neu wedi'u cwblhau. Mae hyn yn cynnwys y llinell amser trosglwyddo, allweddair, crynodeb, a rhannau paragraff.
Tocynnau Dilysiant Ochr y Cleient
Creu tocyn dilysiant dros dro ar gyfer ceisiadau ochr y cleient. Gweithredu ceisiadau API yn ddiogel mewn porwyr gwe heb arddangos eich allweddi API.
Scroll Up