Open in
CDN / scenarijaus žyma
Pridėkite ThunderPhone balso valdiklį prie bet kurios svetainės nenaudodami rinkinio kūrimo įrankio
CDN versija viduje komplektuoja React, todėl valdiklį galite naudoti statinėse svetainėse, WordPress, Webflow arba bet kuriame puslapyje, kuriame galite pridėti HTML. Nereikia nei npm, nei paketų rinkiklio, nei sistemos.
CDN URL
<link rel="stylesheet" href="https://cdn.thunderphone.com/widget/latest/style.css" />
<script src="https://cdn.thunderphone.com/widget/latest/widget.js"></script><!-- Each stable release also publishes an immutable /widget/vX.Y.Z/ path
matching the @thunderphone/widget npm version (v1.1.2 at the time of
writing). If you pin, you own updating the URL for new releases. -->
<link rel="stylesheet" href="https://cdn.thunderphone.com/widget/v1.1.2/style.css" />
<script src="https://cdn.thunderphone.com/widget/v1.1.2/widget.js"></script>Pagrindinis naudojimas
<!DOCTYPE html>
<html>
<head>
<link rel="stylesheet" href="https://cdn.thunderphone.com/widget/latest/style.css" />
</head>
<body>
<div id="thunderphone"></div>
<script src="https://cdn.thunderphone.com/widget/latest/widget.js"></script>
<script>
ThunderPhone.mount({
element: '#thunderphone',
publishableKey: 'pk_live_your_publishable_key',
})
</script>
</body>
</html>Valdiklis prijungiamas prie tikslinio elemento ir rodomas kaip fiksuotos padėties juosta viename iš peržiūros srities kampų (numatytoji padėtis – bottom-right, valdoma parinktimi position). Prijungimo elementas yra tik React šaknis – jo vieta puslapyje neturi įtakos tam, kur rodomas valdiklis.
Prijungimo parinktys
ThunderPhone.mount() priima tas pačias parinktis kaip React komponentas ir papildomą savybę element:
| Parinktis | Tipas | Privaloma | Numatytoji reikšmė | Aprašas |
|---|---|---|---|---|
element | string | HTMLElement | Taip | -- | CSS parinkiklis (pvz., '#thunderphone') arba DOM elemento nuoroda. |
publishableKey | string | Taip | -- | Viešinamas API raktas (pk_live_...). Agentas automatiškai nustatomas pagal rakto valdiklio konfigūraciją. |
theme | 'light' | 'dark' | Ne | 'light' | Spalvų schema. |
primaryColor | string | Ne | '#000000' (light) / '#ffffff' (dark) | CSS spalvos eilutė, naudojama kaip akcento spalva. |
title | string | Ne | 'Voice assistant' | Valdiklio juostoje rodomas tekstas. |
position | 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left' | Ne | 'bottom-right' | Fiksuota padėtis peržiūros srityje. |
apiBase | string | Ne | 'https://api.thunderphone.com/v1' | API bazinio URL perrašymas. |
language | string | Ne | -- | Sesijos kalbos perrašymas – kalbos kodas arba lokalė, pvz., en, es arba fr-FR. Jei nenustatyta, taikoma sukonfigūruota agento kalba. Reikalingas language rakto naršyklės perrašymo nustatymuose. |
voice | string | Ne | -- | Sesijos balso perrašymas – balso pavadinimas, pvz., maria. Jei nenustatyta, taikomas sukonfigūruotas agento balsas. Reikalingas voice rakto naršyklės perrašymo nustatymuose. |
context | string | Ne | -- | Agentui perduodamas sesijos faktinis puslapio arba svetainės kontekstas. Serverio pusėje sutrumpinamas iki 12 000 simbolių. Reikalingas context rakto naršyklės perrašymo nustatymuose. |
onConnect | () => void | Ne | -- | Iškviečiama prisijungus prie balso sesijos. |
onDisconnect | () => void | Ne | -- | Iškviečiama pasibaigus sesijai. |
onError | (error) => void | Ne | -- | Iškviečiama įvykus klaidoms. Klaida turi laukus error (kodas) ir message. |
ringtone | boolean | string | Ne | false | Jungiantis leisti skambėjimo toną. Numatytojo skambėjimo tono reikšmė true, o pasirinktinio garso – URL eilutė. |
Išvalymas
ThunderPhone.mount() grąžina valdiklio egzempliorių su išvalymo metodais:
<script>
var widget = ThunderPhone.mount({
element: '#thunderphone',
publishableKey: 'pk_live_your_publishable_key',
})
// Later, when you want to remove the widget:
widget.unmount()
// Or equivalently:
widget.destroy()
</script>Tiek unmount(), tiek destroy() atlieka tą patį veiksmą – atjungia bet kokį aktyvų balso seansą ir pašalina valdiklį iš DOM. Naudokite tą, kuris jūsų kode atrodo tinkamesnis.
Pavyzdžiai
Tamsi tema su pasirinktine spalva
<div id="thunderphone"></div>
<link rel="stylesheet" href="https://cdn.thunderphone.com/widget/latest/style.css" />
<script src="https://cdn.thunderphone.com/widget/latest/widget.js"></script>
<script>
ThunderPhone.mount({
element: '#thunderphone',
publishableKey: 'pk_live_your_publishable_key',
theme: 'dark',
primaryColor: '#8b5cf6',
title: 'Talk to our AI',
})
</script>Pasirinktinė padėtis
<div id="thunderphone"></div>
<script src="https://cdn.thunderphone.com/widget/latest/widget.js"></script>
<script>
ThunderPhone.mount({
element: '#thunderphone',
publishableKey: 'pk_live_your_publishable_key',
position: 'bottom-left',
})
</script>Su įvykių atgaliniais iškvietimais
<div id="thunderphone"></div>
<link rel="stylesheet" href="https://cdn.thunderphone.com/widget/latest/style.css" />
<script src="https://cdn.thunderphone.com/widget/latest/widget.js"></script>
<script>
ThunderPhone.mount({
element: '#thunderphone',
publishableKey: 'pk_live_your_publishable_key',
onConnect: function () {
console.log('Call started')
},
onDisconnect: function () {
console.log('Call ended')
},
onError: function (error) {
console.error('Widget error:', error.error, error.message)
},
})
</script>Su skambėjimo tonu
<div id="thunderphone"></div>
<link rel="stylesheet" href="https://cdn.thunderphone.com/widget/latest/style.css" />
<script src="https://cdn.thunderphone.com/widget/latest/widget.js"></script>
<script>
ThunderPhone.mount({
element: '#thunderphone',
publishableKey: 'pk_live_your_publishable_key',
ringtone: true, // or a custom URL: 'https://example.com/ringtone.mp3'
})
</script>Naudojant DOM elemento nuorodą
<div id="thunderphone"></div>
<script src="https://cdn.thunderphone.com/widget/latest/widget.js"></script>
<script>
var container = document.getElementById('thunderphone')
ThunderPhone.mount({
element: container,
publishableKey: 'pk_live_your_publishable_key',
})
</script>WordPress / CMS integracija
Pridėkite tai prie pasirinktinio HTML bloko arba savo temos poraštės:
<link rel="stylesheet" href="https://cdn.thunderphone.com/widget/latest/style.css" />
<script src="https://cdn.thunderphone.com/widget/latest/widget.js"></script>
<div id="thunderphone-widget"></div>
<script>
ThunderPhone.mount({
element: '#thunderphone-widget',
publishableKey: 'pk_live_your_publishable_key',
})
</script>Trikčių šalinimas
Valdiklis nerodomas
Įsitikinkite, kad įkelti ir CSS, ir JS failai. Naršyklės konsolėje patikrinkite, ar nėra tinklo klaidų. Prieš iškviesdami ThunderPhone.mount(), patikrinkite, ar tikslinis elementas yra DOM.
ThunderPhone neapibrėžtas
Scenarijus dar neįkeltas. Įsitikinkite, kad <script> žyma, skirta widget.js, yra prieš prijungimo iškvietimą, arba apgaubkite prijungimo iškvietimą DOMContentLoaded klausytoju.
Domenas neleidžiamas
Pridėkite savo domeną prie valdiklio leidžiamų domenų sąrašo puslapyje Žiniatinklio valdikliai adresu app.thunderphone.com. Gamybinėje aplinkoje localhost automatiškai neleidžiamas; pridėkite jį prie sąrašo, kad galėtumėte testuoti vietoje.