ThunderPhone v3 ಈಗ ಲೈವ್ ಆಗಿದೆ.ನೀವೇ ನೇರವಾಗಿ ಆರಂಭಿಸಿ — 2¢/ನಿಮಿಷದಿಂದ.ಘೋಷಣೆ ಓದಿ

Widget

React ಕಾಂಪೊನೆಂಟ್

React ಅಪ್ಲಿಕೇಶನ್‌ನಲ್ಲಿ ThunderPhone ಧ್ವನಿ ವಿಜೆಟ್ ಅನ್ನು ಎಂಬೆಡ್ ಮಾಡಿ

ThunderPhoneWidget ಘಟಕವು ಮ್ಯೂಟ್ ಮಾಡಲು, ಕರೆಯನ್ನು ಕೊನೆಗೊಳಿಸಲು ಮತ್ತು ಸಂಪರ್ಕ ಸ್ಥಿತಿಯನ್ನು ಪ್ರದರ್ಶಿಸಲು ಅಂತರ್ನಿರ್ಮಿತ ನಿಯಂತ್ರಣಗಳಿರುವ ಗ್ಲಾಸ್‌ಮಾರ್ಫಿಕ್ ಕಾಲ್ ಬಾರ್ ಅನ್ನು ರೆಂಡರ್ ಮಾಡುತ್ತದೆ. React ಅಪ್ಲಿಕೇಶನ್‌ಗೆ ಧ್ವನಿ AI ಸೇರಿಸಲು ಇದು ಅತ್ಯಂತ ವೇಗವಾದ ಮಾರ್ಗವಾಗಿದೆ.

ಸ್ಥಾಪನೆ

npm install @thunderphone/widget

ಮೂಲ ಬಳಕೆ

import { ThunderPhoneWidget } from '@thunderphone/widget'
import '@thunderphone/widget/style.css'
 
function App() {
  return (
    <ThunderPhoneWidget
      publishableKey="pk_live_your_publishable_key"
    />
  )
}

ಪ್ರಾಪ್‌ಗಳು

ಘಟಕವು ThunderPhoneWidgetProps ಮೂಲಕ ಈ ಕೆಳಗಿನ ಪ್ರಾಪ್‌ಗಳನ್ನು ಸ್ವೀಕರಿಸುತ್ತದೆ:

ಗುಣಲಕ್ಷಣಪ್ರಕಾರಅಗತ್ಯವಿದೆಪೂರ್ವನಿಯೋಜಿತವಿವರಣೆ
publishableKeystringಹೌದು--ಡ್ಯಾಶ್‌ಬೋರ್ಡ್‌ನ ವೆಬ್ ವಿಜೆಟ್‌ಗಳು ವಿಭಾಗದಿಂದ ಪ್ರಕಟಿಸಬಹುದಾದ API ಕೀ (pk_live_...). ಕೀಯ ವಿಜೆಟ್ ಸಂರಚನೆಯಿಂದ ಏಜೆಂಟ್ ಸ್ವಯಂಚಾಲಿತವಾಗಿ ನಿರ್ಧರಿಸಲಾಗುತ್ತದೆ.
theme'light' | 'dark'ಇಲ್ಲ'light'ಬಣ್ಣ ವಿನ್ಯಾಸ. ವಿಜೆಟ್ ಮೂಲಕ್ಕೆ tp--light ಅಥವಾ tp--dark ವರ್ಗವನ್ನು ಅನ್ವಯಿಸುತ್ತದೆ.
primaryColorstringಇಲ್ಲ'#000000' (ಬೆಳಕು) / '#ffffff' (ಗಾಢ)ಉಚ್ಚಾರಣಾ ಬಣ್ಣವಾಗಿ ಬಳಸುವ CSS ಬಣ್ಣ ಸ್ಟ್ರಿಂಗ್ (ಕರೆ ಬಟನ್, ತರಂಗರೂಪ, ಸಕ್ರಿಯ ಸೂಚಕಗಳು).
titlestringಇಲ್ಲ'Voice assistant'ವಿಜೆಟ್ ಪಟ್ಟಿಯಲ್ಲಿ ಪ್ರದರ್ಶಿಸುವ ಪಠ್ಯ.
position'bottom-right' | 'bottom-left' | 'top-right' | 'top-left'ಇಲ್ಲ'bottom-right'ವಿಜೆಟ್‌ಗೆ ಸ್ಥಿರ ವೀಕ್ಷಣಾಪಟ್ಟಿ ಸ್ಥಾನ.
apiBasestringಇಲ್ಲ'https://api.thunderphone.com/v1'API ಮೂಲ URL ಅತಿಕ್ರಮಣೆ.
languagestringಇಲ್ಲ--ಪ್ರತಿ ಸೆಷನ್‌ನ ಭಾಷೆ ಅತಿಕ್ರಮಣೆ -- en, es, ಅಥವಾ fr-FR ನಂತಹ ಭಾಷಾ ಕೋಡ್ ಅಥವಾ ಲೊಕೇಲ್. ಹೊಂದಿಸದಿದ್ದಾಗ, ಏಜೆಂಟ್‌ನ ಸಂರಚಿತ ಭಾಷೆ ಅನ್ವಯಿಸುತ್ತದೆ. ಕೀಯ ಬ್ರೌಸರ್ ಅತಿಕ್ರಮಣೆಗಳು ಅಡಿಯಲ್ಲಿ language ಅಗತ್ಯವಿದೆ.
voicestringಇಲ್ಲ--ಪ್ರತಿ ಸೆಷನ್‌ನ ಧ್ವನಿ ಅತಿಕ್ರಮಣೆ -- maria ನಂತಹ ಧ್ವನಿ ಹೆಸರು. ಹೊಂದಿಸದಿದ್ದಾಗ, ಏಜೆಂಟ್‌ನ ಸಂರಚಿತ ಧ್ವನಿ ಅನ್ವಯಿಸುತ್ತದೆ. ಕೀಯ ಬ್ರೌಸರ್ ಅತಿಕ್ರಮಣೆಗಳು ಅಡಿಯಲ್ಲಿ voice ಅಗತ್ಯವಿದೆ.
contextstringಇಲ್ಲ--ಏಜೆಂಟ್‌ಗೆ ರವಾನಿಸುವ ಪ್ರತಿ ಸೆಷನ್‌ನ ವಾಸ್ತವಿಕ ಪುಟ ಅಥವಾ ತಾಣದ ಸಂದರ್ಭ (ಉದಾಹರಣೆಗೆ, ಸಂದರ್ಶಕರು ವೀಕ್ಷಿಸುತ್ತಿರುವ ಪುಟದ ವಿವರಗಳು). ಸರ್ವರ್ ಭಾಗದಲ್ಲಿ 12,000 ಅಕ್ಷರಗಳಿಗೆ ಮೊಟಕುಗೊಳಿಸಲಾಗುತ್ತದೆ. ಕೀಯ ಬ್ರೌಸರ್ ಅತಿಕ್ರಮಣೆಗಳು ಅಡಿಯಲ್ಲಿ context ಅಗತ್ಯವಿದೆ.
onConnect() => voidಇಲ್ಲ--ಧ್ವನಿ ಸೆಷನ್ ಯಶಸ್ವಿಯಾಗಿ ಸಂಪರ್ಕಗೊಂಡಾಗ ಕರೆಯಲಾಗುತ್ತದೆ.
onDisconnect() => voidಇಲ್ಲ--ಸೆಷನ್ ಕೊನೆಗೊಂಡಾಗ ಕರೆಯಲಾಗುತ್ತದೆ.
onError(error) => voidಇಲ್ಲ--ದೋಷಗಳಾಗಿದಾಗ ಕರೆಯಲಾಗುತ್ತದೆ. error ಆಬ್ಜೆಕ್ಟ್‌ನಲ್ಲಿ error (ಕೋಡ್) ಮತ್ತು message ಕ್ಷೇತ್ರಗಳಿವೆ.
classNamestringಇಲ್ಲ--ವಿಜೆಟ್ ಕಂಟೇನರ್‌ಗೆ ಅನ್ವಯಿಸುವ ಹೆಚ್ಚುವರಿ CSS ವರ್ಗದ ಹೆಸರು.
ringtoneboolean | stringಇಲ್ಲfalseಸಂಪರ್ಕಿಸುವಾಗ ರಿಂಗ್‌ಟೋನ್ ಪ್ಲೇ ಮಾಡಿ. ಪೂರ್ವನಿಯೋಜಿತ ರಿಂಗ್‌ಟೋನ್‌ಗೆ true, ಅಥವಾ ಕಸ್ಟಮ್ ಆಡಿಯೊಗೆ URL ಸ್ಟ್ರಿಂಗ್ ಬಳಸಿ.

ಉದಾಹರಣೆಗಳು

ಕಸ್ಟಮ್ ಬಣ್ಣದೊಂದಿಗೆ ಡಾರ್ಕ್ ಥೀಮ್

import { ThunderPhoneWidget } from '@thunderphone/widget'
import '@thunderphone/widget/style.css'
 
function App() {
  return (
    <ThunderPhoneWidget
      publishableKey="pk_live_your_publishable_key"
      theme="dark"
      primaryColor="#8b5cf6"
      title="Talk to our AI"
    />
  )
}

ಕಸ್ಟಮ್ ಸ್ಥಾನ

import { ThunderPhoneWidget } from '@thunderphone/widget'
import '@thunderphone/widget/style.css'
 
function App() {
  return (
    <ThunderPhoneWidget
      publishableKey="pk_live_your_publishable_key"
      position="bottom-left"
    />
  )
}

ಪ್ರತಿ-ಸೆಷನ್ ಭಾಷೆ, ಧ್ವನಿ ಮತ್ತು ಸಂದರ್ಭ

ಕರೆ ಪ್ರಾರಂಭವಾದಾಗ language, voice, ಮತ್ತು context ಪ್ರಾಪ್‌ಗಳನ್ನು ಸೆಷನ್ ವಿನಂತಿಗೆ (POST /widget/session) ಫಾರ್ವರ್ಡ್ ಮಾಡಲಾಗುತ್ತದೆ; ಆ ಸೆಷನ್‌ಗೆ ಏಜೆಂಟ್‌ನ ಕಾನ್ಫಿಗರ್ ಮಾಡಲಾದ ಡೀಫಾಲ್ಟ್‌ಗಳನ್ನು ಅವು ಅತಿಕ್ರಮಿಸುತ್ತವೆ. ನೀವು ಬಳಸುವ ಪ್ರತಿಯೊಂದು ಪ್ರಾಪ್‌ಅನ್ನು ಡ್ಯಾಶ್‌ಬೋರ್ಡ್‌ನಲ್ಲಿ ವಿಜೆಟ್‌ಗೆ ಬ್ರೌಸರ್ ಅತಿಕ್ರಮಣೆಗಳು ಅಡಿಯಲ್ಲಿ ಸಕ್ರಿಯಗೊಳಿಸಿ (ಅಥವಾ ಕೀಯ allowed_overrides ನಲ್ಲಿ). ಹೊಸ ವಿಜೆಟ್‌ಗಳು ಯಾವುದನ್ನೂ ಸ್ವೀಕರಿಸುವುದಿಲ್ಲ, ಮತ್ತು ನಿಷ್ಕ್ರಿಯವಾಗಿರುವ ಒಂದನ್ನು ಒಳಗೊಂಡ ಸೆಷನ್ ವಿನಂತಿಯು 400 override_not_allowed ನೊಂದಿಗೆ ವಿಫಲವಾಗುತ್ತದೆ; ಬ್ರೌಸರ್ ಅತಿಕ್ರಮಣೆಗಳು ನೋಡಿ.

import { ThunderPhoneWidget } from '@thunderphone/widget'
import '@thunderphone/widget/style.css'
 
function PricingPageWidget() {
  return (
    <ThunderPhoneWidget
      publishableKey="pk_live_your_publishable_key"
      language="es"
      voice="maria"
      context="Page: Pricing. Plans: Starter $29/mo, Pro $99/mo. Annual billing saves 20%."
    />
  )
}

ಸಂದರ್ಶಕರು ಇರುವ ಪುಟದ ಬಗ್ಗೆ ವಾಸ್ತವಿಕ ಮಾಹಿತಿಯನ್ನು ಏಜೆಂಟ್‌ಗೆ ನೀಡಲು context ಬಳಸಿ -- ಉತ್ಪನ್ನದ ವಿವರಗಳು, ಬೆಲೆ ನಿಗದಿ, ಅಥವಾ ಪುಟ-ನಿರ್ದಿಷ್ಟ FAQಗಳು. ಏಜೆಂಟ್ ಇದನ್ನು ಸೂಚನೆಗಳಾಗಿ ಅಲ್ಲದೆ ಪುಟದ ವಿಷಯವಾಗಿ ಪರಿಗಣಿಸುತ್ತದೆ. ಇದನ್ನು ಸರ್ವರ್ ಬದಿಯಲ್ಲಿ 12,000 ಅಕ್ಷರಗಳಿಗೆ ಮೊಟಕುಗೊಳಿಸಲಾಗುತ್ತದೆ.

ಈವೆಂಟ್ ಕಾಲ್‌ಬ್ಯಾಕ್‌ಗಳೊಂದಿಗೆ

import { ThunderPhoneWidget } from '@thunderphone/widget'
import '@thunderphone/widget/style.css'
 
function SupportWidget() {
  return (
    <ThunderPhoneWidget
      publishableKey="pk_live_your_publishable_key"
      onConnect={() => {
        console.log('Voice session connected')
        analytics.track('widget_call_started')
      }}
      onDisconnect={() => {
        console.log('Voice session ended')
        analytics.track('widget_call_ended')
      }}
      onError={(error) => {
        console.error(`Widget error: ${error.error} - ${error.message}`)
      }}
    />
  )
}

ಕಸ್ಟಮ್ ಸ್ಟೈಲಿಂಗ್‌ನೊಂದಿಗೆ

import { ThunderPhoneWidget } from '@thunderphone/widget'
import '@thunderphone/widget/style.css'
 
function BrandedWidget() {
  return (
    <ThunderPhoneWidget
      publishableKey="pk_live_your_publishable_key"
      primaryColor="#4a90d9"
      className="my-custom-widget"
    />
  )
}
.my-custom-widget .tp-button--end {
  background-color: #e74c3c;
}

ಲಭ್ಯವಿರುವ ಎಲ್ಲಾ CSS ಕ್ಲಾಸ್‌ಗಳು ಮತ್ತು ಕಸ್ಟಮ್ ಪ್ರಾಪರ್ಟಿಗಳಿಗಾಗಿ ಸ್ಟೈಲಿಂಗ್ ಮಾರ್ಗದರ್ಶಿ ನೋಡಿ.

ರಿಂಗ್‌ಟೋನ್‌ನೊಂದಿಗೆ

ಸಂಪರ್ಕವನ್ನು ಸ್ಥಾಪಿಸುತ್ತಿರುವಾಗ ಫೋನ್ ರಿಂಗ್ ಆಗುವ ಧ್ವನಿಯನ್ನು ಪ್ಲೇ ಮಾಡಿ:

import { ThunderPhoneWidget } from '@thunderphone/widget'
import '@thunderphone/widget/style.css'
 
function PhoneWidget() {
  return (
    <ThunderPhoneWidget
      publishableKey="pk_live_your_publishable_key"
      ringtone={true}
    />
  )
}

ಆಡಿಯೊ ಫೈಲ್ URL ಅನ್ನು ಪಾಸ್ ಮಾಡುವ ಮೂಲಕ ಕಸ್ಟಮ್ ರಿಂಗ್‌ಟೋನ್ ಬಳಸಿ:

<ThunderPhoneWidget
  publishableKey="pk_live_your_publishable_key"
  ringtone="https://example.com/my-ringtone.mp3"
/>

ವಿಜೆಟ್ connecting ಸ್ಥಿತಿಯಲ್ಲಿರುವಾಗ ರಿಂಗ್‌ಟೋನ್ ಲೂಪ್ ಆಗುತ್ತದೆ ಮತ್ತು ಏಜೆಂಟ್ ಸಂಪರ್ಕಿಸಿದಾಗ ಸರಾಗವಾಗಿ ಫೇಡ್ ಔಟ್ ಆಗುತ್ತದೆ.

ಕಸ್ಟಮ್ API ಬೇಸ್‌ನೊಂದಿಗೆ

<ThunderPhoneWidget
  publishableKey="pk_live_your_publishable_key"
  apiBase="https://your-proxy.example.com/v1"
/>

ದೋಷ ನಿರ್ವಹಣೆ

onError ಕಾಲ್‌ಬ್ಯಾಕ್ ಫೈರ್ ಆದಾಗ, ಅದು ಎರಡು ಫೀಲ್ಡ್‌ಗಳನ್ನು ಹೊಂದಿರುವ ದೋಷ ಆಬ್ಜೆಕ್ಟ್ ಅನ್ನು ಪಡೆಯುತ್ತದೆ:

ಫೀಲ್ಡ್ವಿಧವಿವರಣೆ
errorstringಯಂತ್ರ-ಓದಬಹುದಾದ ದೋಷ ಕೋಡ್
messagestringಮಾನವ-ಓದಬಹುದಾದ ದೋಷ ವಿವರಣೆ

ಸಾಮಾನ್ಯ ದೋಷ ಕೋಡ್‌ಗಳಲ್ಲಿ ಅನುಮತಿಸದ ಡೊಮೇನ್, ಏಜೆಂಟ್ ಕಂಡುಬಂದಿಲ್ಲ, ಮತ್ತು ಅಮಾನ್ಯ API ಕೀ ಸೇರಿವೆ.


ಮುಂದಿನ ಹಂತಗಳು