mocap-clips
/mocap-clips
Zapisuje, wyświetla, pobiera, aktualizuje i usuwa nagrania ruchu do awatara na three.ws przez bibliotekę mocap.
- Autor
- nirholas ↗
- Repozytorium
- three.ws ↗
- Licencja
- Apache-2.0
- Ostatnia zmiana repozytorium
- 13.11.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 1
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 1
Brak sygnałów. Repozytorium zmienione 13.11.2026, bez odwołań do wycofanych modeli i API.
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
- Install
- Auth
- Functions
- Recording shape
- Example
- Errors
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.