SDK 与库

面向 JavaScript 及各大主流前端框架的官方客户端库。安装、配置，几分钟内即可开始识别访客。

所有 SDK 均已发布至 npm（v0.1.3）。立即安装——在 npm 上查看 @tracio 系列包。

框架支持

面向 JavaScript 及各大主流前端框架的官方 SDK 支持。

语言	包	安装命令	状态	文档
JavaScript	`@tracio/sdk`	`npm install @tracio/sdk`	已提供	文档
React	`@tracio/react`	`npm install @tracio/react @tracio/sdk`	已提供	文档
Vue	`@tracio/vue`	`npm install @tracio/vue @tracio/sdk`	已提供	文档
Angular	`@tracio/angular`	`npm install @tracio/angular @tracio/sdk`	已提供	文档
Svelte	`@tracio/svelte`	`npm install @tracio/svelte @tracio/sdk`	已提供	文档

快速上手

复制粘贴示例，快速运行起来。

JavaScript

已提供

npm install @tracio/sdk

import { Tracio } from '@tracio/sdk'
const tracio = Tracio.init({ publicKey: '5ca175fc...' })
const result = await tracio.getResult()
console.log(result.visitorId)
if (result.bot.detected) {
  console.warn('bot, confidence:', result.bot.confidence)
}

React

已提供

npm install @tracio/react @tracio/sdk

import { TracioProvider, useVisitorId } from '@tracio/react'
function App() {
  return (
    <TracioProvider publicKey={process.env.NEXT_PUBLIC_TRACIO_KEY!}>
      <Page />
    </TracioProvider>
  )
}
function Page() {
  const { data: visitorId, isLoading, error } = useVisitorId()
  return <p>Visitor: {visitorId}</p>
}

Vue

已提供

npm install @tracio/vue @tracio/sdk

import { createApp } from 'vue'
import { TracioPlugin } from '@tracio/vue'
import App from './App.vue'
createApp(App)
  .use(TracioPlugin, { publicKey: import.meta.env.VITE_TRACIO_KEY })
  .mount('#app')
// in a component:
// const { data: visitorId, isLoading, error } = useVisitorId()

Angular

已提供

npm install @tracio/angular @tracio/sdk

import { provideTracio } from '@tracio/angular'
export const appConfig: ApplicationConfig = {
  providers: [provideTracio({ publicKey: '5ca175fc...' })],
}
// in a component:
// readonly tracio = inject(TracioService)
// tracio.visitorId() // signal

Svelte

已提供

npm install @tracio/svelte @tracio/sdk

<script>
  import { Tracio } from '@tracio/svelte'
  import { browser } from '$app/environment'
  if (browser) Tracio.init({ publicKey: import.meta.env.VITE_TRACIO_KEY })
</script>
<!-- in a component: -->
<!-- const visitor = useVisitorId() -->
<!-- $visitor.data / $visitor.isLoading -->

准备好开始了吗？

免费试用 Tracio，每月 2,500 次 API 调用。无需信用卡。

免费开始联系销售