.png?alt=media&token=3a638284-cfcd-498e-91a1-17f629869f7b)
附加脚本
var ConvaiNpc = pc.createScript('convaiNpc');
/** 正在加载 convai-sdk CDN */
var convaiClient = null;
var userTextStream = ""; // 存储用户的文本输入
var npcTextStream = ""; // 存储 NPC 的文本响应
var keyPressed = false; // 记录 "T" 键是否被按下
var isTalking = false; // 表示 NPC 当前是否正在说话
var conversationActive = false; // 表示当前是否有正在进行的对话
var visemeData = []; // 存储用于口型同步动画的 viseme 数据
var visemeDataActive = false; // 表示 viseme 数据是否可用
var formLoaded = false; // 表示表单是否已加载
let timeoutId;
/**
* 使用 API 密钥、角色 ID 以及用于启用音频录制器和播放器的标志初始化 ConvaiClient。请先在 Start() 中调用它
* 设置多个回调，以处理来自 Convai Client 的不同类型响应。
* @param {string} apiKey - Convai 服务的 API 密钥。
* @param {string} characterId - Convai 服务中使用的角色 ID。
* @param {boolean} enableAudioRecorder - 启用音频录制器的标志。
* @param {boolean} enableAudioPlayer - 启用音频播放器的标志。
* @param {number} faceModal - 角色要使用的面部模型。
* @param {boolean} enableFacialData - 启用面部数据的标志。
*/
function initializeConvaiClient () {
console.log("Convai 客户端已启动。");
convaiClient = new ConvaiClient({
apiKey: "", // 替换为你的 API 密钥
characterId: "", // 替换为你的角色 ID
enableAudio: true,
faceModal: 3,
enableFacialData: true,
});
// 错误回调
convaiClient.setErrorCallback(function(type, statusMessage) {
console.log("错误回调", type, statusMessage);
});
// 响应回调
convaiClient.setResponseCallback(function(response) {
// 处理用户查询
if (response.hasUserQuery) {
var transcript = response.getUserQuery();
if (transcript) {
var isFinal = transcript?.getIsFinal();
var transcriptText = transcript.getTextData();
if (isFinal) {
userTextStream += " " + transcriptText;
}
userTextStream = transcriptText;
}
}
// 处理音频响应
if (response.hasAudioResponse()) {
var audioResponse = response.getAudioResponse();
npcTextStream += " " + audioResponse.getTextData();
// 处理用于口型同步动画的 viseme 数据
if (audioResponse.hasVisemesData()) {
let lipsyncData = audioResponse.getVisemesData().array[0];
if (lipsyncData[0] !== -2) {
visemeData.push(lipsyncData);
visemeDataActive = true;
}
} else {
visemeDataActive = false;
}
}
});
}
// 处理按键按下事件以开始音频输入
function handleKeyDown(e) {
const convaiFormEl = document.getElementById("convai-input");
if (convaiClient && e.keyCode === 84 && !keyPressed && !(document.activeElement === convaiFormEl)) {
e.stopPropagation();
e.preventDefault();
keyPressed = true;
userTextStream = "";
npcTextStream = "";
convaiClient.startAudioChunk();
conversationActive = true;
}
}
// 处理按键松开事件以停止音频输入
function handleKeyUp(e) {
const convaiFormEl = document.getElementById("convai-input");
if (convaiClient && e.keyCode === 84 && keyPressed && !(document.activeElement === convaiFormEl)) {
e.preventDefault();
keyPressed = false;
clearTimeout(timeoutId);
timeoutId = setTimeout(() => {
convaiClient.endAudioChunk();
}, 500);
}
}
// 为按键按下和松开添加事件监听器
window.addEventListener("keydown", handleKeyDown);
window.addEventListener("keyup", handleKeyUp);
// 每个实体只调用一次的初始化代码
ConvaiNpc.prototype.initialize = function() {
initializeConvaiClient();
// 设置音频播放回调
convaiClient.onAudioPlay(() => {
isTalking = true;
});
convaiClient.onAudioStop(() => {
isTalking = false;
conversationActive = false;
});
};
// 根据说话状态处理动画
ConvaiNpc.prototype.handleAnimation = function() {
this.entity.anim.setBoolean("Talking", isTalking);
};
// 每帧调用的更新代码
ConvaiNpc.prototype.update = function(dt) {
this.handleAnimation();
// 检查表单是否已加载并添加事件监听器
if (!formLoaded && document.getElementById("convai-form")) {
this.formListener();
formLoaded = true;
}
};
// 为表单提交添加事件监听器
ConvaiNpc.prototype.formListener = function() {
document.getElementById("convai-form").addEventListener("submit", (e) => {
e.preventDefault();
var inputValue = document.getElementById("convai-input").value;
window.convaiClient.sendTextChunk(inputValue);
userTextStream = inputValue;
document.getElementById("convai-form").reset();
conversationActive = true;
npcTextStream = "";
});
}
// 创建一个名为 'headTracking' 的新脚本
var HeadTracking = pc.createScript('headTracking');
// 递归按名称查找子实体的辅助函数
HeadTracking.prototype.findChild = function(children, matchName) {
for (let child of children) {
if (child.name.includes(matchName)) {
return child;
}
if (child.children) {
const foundChild = this.findChild(child.children, matchName);
if (foundChild) {
return foundChild;
}
}
}
return null;
};
// 计算两个向量之间弧度角的函数
HeadTracking.prototype.getRadianAngle = function(vecA, vecB) {
dot = vecA.normalize().dot(vecB.normalize());
return Math.acos(dot);
};
// 每个实体只调用一次的初始化代码
HeadTracking.prototype.initialize = function() {
// 查找头部、左眼和右眼组件
this.headComponent = this.entity.findByName("Head");
this.leftEye = this.entity.findByName("LeftEye");
this.rightEye = this.entity.findByName("RightEye");
};
// 在更新循环后调用的函数
HeadTracking.prototype.postUpdate = function(dt) {
// 检查摄像机位置是否可用
if (window.fpsCamera?.position !== undefined) {
const cameraPosition = window.fpsCamera.getPosition().clone();
const angle = this.getRadianAngle(this.headComponent.forward, window.fpsCamera.forward);
const degree = angle * pc.math.RAD_TO_DEG;
// 如果角度在 45 度以内，则看向摄像机位置
if (degree <= 45) {
this.headComponent.lookAt(-cameraPosition.x, cameraPosition.y, -cameraPosition.z);
this.leftEye.lookAt(-cameraPosition.x, cameraPosition.y, -cameraPosition.z);
this.rightEye.lookAt(-cameraPosition.x, cameraPosition.y, -cameraPosition.z);
}
}
};
附加脚本