Przejdź do treści
Biblioteka skilli
Programowanie · Integracja z narzędziem

mocap-clips

/mocap-clips

Zapisuje, wyświetla, pobiera, aktualizuje i usuwa nagrania ruchu do awatara na three.ws przez bibliotekę mocap.

Repozytorium
three.ws ↗
Licencja
Apache-2.0
Ostatnia zmiana repozytorium
13.11.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
1
Przestarzałość

Brak sygnałów. Repozytorium zmienione 13.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

Co robi i kiedy

Zapisuje, wyświetla, pobiera, aktualizuje i usuwa nagrania ruchu do awatara na three.ws przez bibliotekę mocap.

Oryginalny opis (EN)

Save, list, fetch, update and delete motion capture clips on three.ws with @three-ws/mocap. Use when a task needs to store or replay a face, pose or hand recording on an avatar.

Jak działa

  1. Install
  2. Auth
  3. Functions
  4. Recording shape
  5. Example
  6. Errors
Sekcje z nagłówków SKILL.md, w oryginale · 60 linii, 357 słów
Podgląd SKILL.md
---
name: mocap-clips
description: Save, list, fetch, update and delete motion capture clips on three.ws with @three-ws/mocap. Use when a task needs to store or replay a face, pose or hand recording on an avatar.
---

# Mocap clips with @three-ws/mocap

A thin Node/browser client over the `/api/mocap/clips` endpoints on three.ws. It stores browser-recorded frames and returns them for replay on any avatar.

## Install

```
npm install @three-ws/mocap
```

Node 18 or newer. Zero dependencies. The base URL defaults to `https://three.ws` and can be overridden with the `baseUrl` option or the `THREE_WS_BASE_URL` env var.

## Auth

Writes need a session cookie or a bearer token with the right scope. Reads of public clips are open. Pass the token per call or bind it once:

```js
import { createMocap } from '@three-ws/mocap';
const mocap = createMocap({ token: process.env.THREEWS_TOKEN });
```

Cookie-authenticated writes also need `X-CSRF-Token` (mint one with `GET /api/csrf-token`). Bearer tokens do not.

## Functions

All are exported both as top-level functions and on the `createMocap()` client.

- `saveClip(recording, meta, auth?)`: `POST /api/mocap/clips`. `meta.name` is required (1 to 120 chars). Optional `slug`, `description`, `tags`, `visibility` (`private` | `unlisted` | `public`), `avatarId`.
- `getClip(idOrSlug, auth?)`: one clip with its full `frames`.
- `listClips(auth?, { limit, cursor, kind, includePublic })`: metadata only, returns `{ items, nextCursor }`. `kind` is `face`, `pose`, `hand` or `vmc`.
- `updateClip(idOrSlug, patch, auth?)`: owner only. Patch may include `name`, `description`, `tags`, `visibility`, `avatarId`, `price`.
- `deleteClip(idOrSlug, auth?)`: soft delete, returns `{ ok }`.
- `supportedFormats`, `formatKind(format)`: helpers.

## Recording shape

```js
{ format: 'three.ws.face-mocap.v1', duration: 2.4, frames: [{ t: 0, shapes: { jawOpen: 0.1 }, mat: null }] }
```

Supported `format` values: `three.ws.face-mocap.v1`, `three.ws.pose-mocap.v1`, `three.ws.hand-mocap.v1`, `three.ws.vmc.v1`. At most 18000 frames per clip.

## Example

```js
import { saveClip, getClip, listClips } from '@three-ws/mocap';

const token = process.env.THREEWS_TOKEN;
const clip = await saveClip(recording, { name: 'Wave hello', visibility: 'unlisted', tags: ['wave'] }, { token });
const full = await getClip(clip.slug ?? clip.id, { token });
const mine = await listClips({ token }, { kind: 'face', limit: 20 });
```

## Errors

Failures throw `ThreeWsError` (`code`, `status`, `detail`, `retryAfter`). A 402 throws `PaymentRequiredError` with the x402 `accepts` challenge. Do not retry a 402 without the user approving the payment.

Frames come from a webcam or video capture running in the browser. This package does not capture, it persists and fetches.

Wersje

W bazie nie ma innych skilli o nazwie mocap-clips.

Migawka bazy z 13.11.2026 · wersja paczki 91d875c52858 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100motion-clip-cli
    Generuje klip animacji humanoidalnej dla three.js z opisu tekstowego lub partytury ruchu, gdy brakuje nagrania mocap.
  • 100avatar-voice
    Daje awatarowi głos i twarz przez narzędzia audio: syntezę mowy, transkrypcję, ścieżki lipsync i klipy mocap.
  • 100scenario-unity-animation
    Pomaga w animacji postaci i kamerach w Unity 6.3: import Mixamo i mocap, Animator Controllers, blend trees, root motion, IK, Animation Rigging, Timeline, Cinemachine 3 oraz naprawa T-pose i ślizgania stóp.
  • 100blender-animation
    Przygotowuje animacje w Blenderze 5.2: akcje z warstwami, klatki kluczowe, NLA, przeniesienie ruchu z mocapu i eksport klipów.
  • 100blender-animation
    Obsługuje animację w Blenderze 5.2: akcje ze slotami i warstwami, API channelbag, keyframing w Pythonie, krzywe F, klipy NLA, biblioteka póz, retargeting mocap/BVH, bake szkieletów, ruch korzenia i eksport klipów.
  • 100scenario-unreal-animation
    Obsługuje animację postaci w UE5: import FBX z Maya, retargeting z IK Rig, Motion Matching, Pose Search, root motion, foot IK, Control Rig oraz koszt Animation Blueprint, MetaHuman LOD i ML Deformer.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.