基础功能

VPetLLM 提供了一系列强大的基础功能来创建和管理虚拟宠物。

宠物创建

创建宠物

import { VPetLLM } from 'vpetllm';

const pet = new VPetLLM({
  name: 'Buddy',
  type: 'dog',
  color: 'brown'
});

支持的宠物类型

• cat - 猫
• dog - 狗
• rabbit - 兔子
• bird - 鸟
• hamster - 仓鼠
• dragon - 龙

交互

对话

// 让宠物说话
pet.speak('Hello!');

// 宠物会自动生成回复
pet.on('speak', (message) => {
  console.log(`Pet: ${message}`);
});

动作

// 执行动作
pet.action('jump');
pet.action('sleep');
pet.action('eat');
pet.action('play');

// 监听动作完成
pet.on('actionComplete', (action) => {
  console.log(`Completed: ${action}`);
});

状态管理

获取宠物状态

// 获取当前状态
const state = pet.getState();
console.log(state);
// 输出: { name: 'Buddy', type: 'dog', mood: 'happy', energy: 80 }

// 获取特定属性
const mood = pet.getMood();
const energy = pet.getEnergy();
const hunger = pet.getHunger();

修改状态

// 改变心情
pet.setMood('happy');

// 增加能量
pet.addEnergy(20);

// 减少饥饿度
pet.feed();

外观定制

改变外观

// 改变颜色
pet.setColor('blue');

// 改变大小
pet.setSize('large');

// 添加配饰
pet.addAccessory('hat');
pet.addAccessory('glasses');

获取外观信息

const appearance = pet.getAppearance();
console.log(appearance);
// 输出: { color: 'blue', size: 'large', accessories: ['hat', 'glasses'] }

学习系统

教宠物新技能

// 教宠物新的动作
pet.learn('trick', {
  name: 'spin',
  description: 'Spin around',
  animation: 'spin'
});

// 执行学到的技能
pet.action('spin');

教宠物新的回复

// 教宠物新的对话
pet.learn('response', {
  trigger: 'hello',
  response: 'Hi there!',
  confidence: 0.9
});

保存和加载

保存宠物状态

// 保存宠物到本地存储
pet.save('my-pet');

// 或导出为 JSON
const petData = pet.export();
console.log(petData);

加载宠物

// 从本地存储加载
const loadedPet = VPetLLM.load('my-pet');

// 或从 JSON 导入
const importedPet = VPetLLM.import(petData);

性能优化

渲染优化

// 启用低功耗模式
pet.setPerformanceMode('low');

// 禁用某些动画
pet.disableAnimation('particles');

// 设置帧率
pet.setFrameRate(30);

最佳实践

1. 及时保存 - 定期保存宠物状态
2. 管理资源 - 及时清理不需要的宠物实例
3. 监听事件 - 使用事件系统而不是轮询
4. 优化性能 - 在低端设备上使用低功耗模式

下一步

• 查看高级功能了解更多
• 浏览博客获取示例和教程