Keural Kit

Keural Kit ஒரே ஒரு ஸ்கிரிப்ட் மூலம் Keural திரைகளை உங்கள் பக்கத்தில் சேர்க்கிறது. திரைகள் Shadow DOM உள்ளே வரையப்படுவதால் உங்கள் பக்கத்தின் CSS உடன் கலக்காது. Kit, Keural இணைய வெளியீட்டின்போது புதுப்பிக்கப்படும். வெளியீட்டிற்குப் பிறகும் பழைய திரை தெரிந்தால், உலாவி மற்றும் CDN தற்காலிக சேமிப்பை அழித்து, window.KeuralKit.__build மூலம் உருவாக்கப்பட்ட நேரத்தைச் சரிபார்க்கவும்.

ஏற்றுதல்இணைப்பை நகலெடு

Kit, நீங்கள் பயன்படுத்தும் Keural சூழலின் இணைய முகவரியிலிருந்து ஏற்றப்படுகிறது. keural.ai பயன்படுத்தினால் முகவரி https://keural.ai. ஆன்-பிரீமைசஸ் அல்லது பிரத்யேகச் சூழலாக இருந்தால், அந்தச் சூழலின் Keural இணைய முகவரியைப் பயன்படுத்தவும். ஸ்கிரிப்டைச் சேர்ப்பதற்கு முன், Kit அழைக்கும் சேவையக முகவரிகளை window.__KEURAL_ENV__ இல் வையுங்கள். மூன்று முகவரிகளும் ஒரே சூழலைச் சேர்ந்தவையாக இருக்க வேண்டும்; இணைக்கும்போது Keural தொடர்பாளரிடம் பெறவும்.

<script>
  window.__KEURAL_ENV__ = {
    NEXT_PUBLIC_API_BASE_URL: '<KEURAL_API_URL>',
    NEXT_PUBLIC_FAST_API_BASE_URL: '<KEURAL_AGENT_URL>',
    NEXT_PUBLIC_MODE: 'prd',
  };
</script>
<script src="<KEURAL_WEB_URL>/plugin/kit/keural.js" async></script>

இதே Kit ஐ இரண்டாவது டொமைனிலும் பயன்படுத்தினால், NEXT_PUBLIC_ADDITIONAL_FRONTEND_URL, NEXT_PUBLIC_ADDITIONAL_API_BASE_URL, NEXT_PUBLIC_ADDITIONAL_FAST_API_BASE_URL ஆகிய மூன்று மதிப்புகளையும் சேர்த்து வழங்கவும். ஒன்று விடுபட்டாலும் பிழை ஏற்படும். மதிப்புகள் பாதை இல்லாத https:// முகவரிகள்.

ஸ்கிரிப்ட் ஏற்றப்பட்டதும் window.KeuralKit கிடைக்கும். React போன்ற SPA களில், ஸ்கிரிப்ட் ஒருமுறை மட்டுமே சேர்க்கப்படும்படி ஏற்றியை உருவாக்கிப் பயன்படுத்தவும்.

export function loadKeuralKit(src = '<KEURAL_WEB_URL>/plugin/kit/keural.js') {
  if (window.KeuralKit) return Promise.resolve(window.KeuralKit);
  return new Promise((resolve, reject) => {
    const s = document.createElement('script');
    s.src = src;
    s.async = true;
    s.onload = () => resolve(window.KeuralKit);
    s.onerror = () => {
      s.remove();
      reject(new Error('Keural Kit failed to load'));
    };
    document.head.appendChild(s);
  });
}

அரட்டையைச் சேர்த்தல்இணைப்பை நகலெடு

const el = document.getElementById('keural-chat')!;

window.KeuralKit.mountChat(el, {
  userInfo: { userId: user.id, name: user.name },
  colorMode: 'light',
  initialData: { message: 'இந்தக் காலாண்டு விற்பனையைச் சுருக்கித் தாருங்கள்', room_name: 'காலாண்டு அறிக்கை' },
  onSessionCreated: (roomId) => router.push(`/c/${roomId}`),
  onError: () => router.push('/'),
});

// திரையை விட்டு வெளியேறும்போது
window.KeuralKit.unmount(el);

• ஏற்கனவே உள்ள உரையாடலைத் திறக்க, sessionId இல் உரையாடல் ID ஐ வையுங்கள்.
• initialData ஐ புதிய உரையாடலைத் திறக்கும்போது மட்டுமே சேர்க்கவும். ஏற்கனவே உள்ள உரையாடலை மீண்டும் திறக்கும்போது சேர்த்தால் அதே செய்தி மீண்டும் அனுப்பப்படும்.
• userInfo.userId இல்லையெனில் பயனர் உள்நுழையாதவராகக் கருதப்படுவார். உள்நுழைவுத் தகவல் தயாரான பின்னர் mount செய்யவும்.

முறைகள்இணைப்பை நகலெடு

mount* மற்றும் update* முறைகள் colorMode மற்றும் userInfo ஐ ஒன்றாகப் பெறும். unmount(el) உறுப்பை மட்டுமே பெறும். update* அதே உறுப்பில் புதிய விருப்பங்களுடன் மீண்டும் வரையும். சாளரத்தைத் திறந்து மூடும்போது open மதிப்பை மாற்றி update* ஐ அழைக்கவும். அதே உறுப்பில் மீண்டும் mount* செய்தால் ஏற்கனவே உள்ள திரை மீண்டும் பயன்படுத்தப்படும்.

mountChat விருப்பங்கள்இணைப்பை நகலெடு

initialDataஇணைப்பை நகலெடு

திரை மொழிஇணைப்பை நகலெடு

Kit திரை கொரிய மொழியில் காட்டப்படும்.

அமைப்புகளும் உள்நுழைவும்இணைப்பை நகலெடு

• பயனர் அமைப்புகளை Keural இணையம் அல்லது செயலியில் மாற்றலாம். Kit திரை அந்த அமைப்புகளைப் பின்பற்றும்.
• உள்நுழைவை உங்கள் சேவை கையாளும்; Kit க்கு உள்நுழைந்த பயனர் தகவல் மட்டும் அனுப்பப்படும்.