 |
API说明—功能点操作 |  |
● 播放视频
● 暂停视频
● 停止视频
● 播放音效
● 停止音效
● 返回音效已播放时间
● 播放特效
● 旋转特效
● 停止特效
播放视频
函数：
int uPlayVideo(time,videoID,fileName, itemId,timePlayed);
参数：
(1) time：整型，播放次数，填0为循环播放。
(2) videoID：整型，视频的功能点id。目前必须填1。
(3) fileName：字符串，本地视频的名字，要带后缀。支持资源库视频。
(4) itemId：字符串，视频依附的物体id。
(5) timePlayed：32位整型，从多久开始播放，单位：毫秒。
返回值：
详见5.4返回值类型。
Eg：
(1) uPlayVideo(1,1,"uw://shengweil/3377699727635013.wmv",uGetItemId());
--在执行脚本所在物体上，从视频的第100毫秒开始播放一个路径为“3377699727635013.wmv”的视频。
暂停视频
函数：
uint32 uPauseVideo(videoID,Playedtime,itemId);
参数：
(1) videoID：整型，视频的功能点id。目前必须填1。
(2) Playedtime：32位整型，定格在该视频多久时的画面上，单位：毫秒。
(3) itemId：字符串，视频依附的物体id。
返回值：
暂停的时间，单位毫秒。
Eg：
(1) uPauseVideo(1,100,uGetItemId());
--暂停执行脚本所在物体上的视频，并定格在该视频第100毫秒时的画面上。
停止视频
函数：
int uStopVideo(videoID,itemId);
参数：
(1) videoID：整型，视频的功能点id。目前必须填1。
(2) itemId：字符串，视频依附的物体id。
返回值：
详见5.4返回值类型。
Eg：
(1) uStopVideo(1,uGetItemId());
--停止执行脚本所在物体上的视频。
播放音效
函数：
int uPlaySound(musicId,times,volume,fileName,timePlayed,itemId);
参数：
(1) musicId：整型，音频的功能点id。目前必须填1。
(2) time：整型，播放次数，填0为循环播放。
(3) volume：整型，音量大小，填写范围0—100。
(4) fileName：字符串，本地音频的名字，如：D:/Work/music/BGM003.mp3。
(5) timePlayed：32位整型，从多久开始播放，单位：毫秒。
(6) itemId：字符串，音频依附的物体id。如果不填默认为执行脚本所在的物体播放。
返回值：
详见5.4返回值类型。
Eg：
(1) uPlaySound (1,1, 50, "D:/Work/music/BGM003.mp3",100,uGetItemId());
--在执行脚本所在物体上，从第100毫秒开始，以0.5倍最大音量，播放一个路径为“D:/Work/music/BGM003.mp3”的音效。
停止音效
函数：
int uStopSound(musicId,itemId);
参数：
(1) musicId：整型，音频的功能点id。目前必须填1。
(2) itemId：字符串，音频依附的物体id。如果不填默认为执行脚本所在的物体播放。
返回值：
详见5.4返回值类型。
Eg：
(1) uStopSound(1,uGetItemId());
--停止执行脚本所在物体上的音频。
返回音效已播放时间
函数：
int uGetSoundTime(musicId,itemId);
参数：
(1) musicId：整型，音频的功能点id。目前必须填1。
(2) itemId：字符串，音频依附的物体id。如果不填默认为执行脚本所在的物体播放。
返回值：
音频已播放的时间，单位：毫秒。
Eg：
(1) uGetSoundTime(1,uGetItemId());
--获得执行脚本所在物体上的音频已播放的时间。
播放特效
函数：
int uPlayPartical(index,pos,path);
参数：
(1) index：整型，特效点索引，目前必需填1。
(2) pos：三维向量，特效点相对于物体的偏移位置。
(3) path：字符串，特效在资源库上的路径，可通过资源库查找。
返回值：
详见5.4返回值类型。
Eg：
(1) pos = G3D.Vector3:new(0,1,0);
uPlayPartical (1,pos, "uw://nailo1/3377699725494013.uParticle");
旋转特效
函数：
int uSetParticalOrient(index,orient);
参数：
(1) index：整型，特效点索引，目前必需填1。
(2) orient：三维向量，特效点相对于x、y、z的旋转角度。
返回值：
详见5.4返回值类型。
Eg：
(1) dir = G3D.Vector3:new(90,0,0);
uSetParticalOrient(1,dir);
--将特效点位置1的特效沿x轴旋转90度。
停止特效
函数：
int uStopPartical(index);
参数：
(1) index：整型，特效点索引，目前必需填1。
返回值：
详见5.4返回值类型。
Eg：
(1) uStopPartical (1);
--停止播放特效点位置1的特效。