詞彙：SessionShell 速查
SessionShell (API) 是 HiNC 所有腳本命令的全域作用範圍。本頁依分類列出每個命令、簡短說明，以及通常用於哪個工作流程。
仿真控制
| 命令 |
說明 |
用於 |
PlayNcFile |
執行 NC 檔 |
基礎仿真 |
PlayNc |
從字串執行 NC 碼 |
基礎仿真 |
PlayCsvFile |
由 CSV 檔驅動仿真 |
基礎仿真、感測器映射 |
RunNcFile |
解析 NC 檔並回傳動作序列（不自動播放） |
— |
RunNc |
解析 NC 字串並回傳動作序列（不自動播放） |
— |
Pace |
在播放中插入可暫停檢查點 |
基礎仿真 |
Pause |
暫停播放器執行 |
基礎仿真 |
Reset |
重置播放器狀態 |
基礎仿真 |
PlayAct |
執行自訂動作物件 |
— |
PlayToolingTeleport |
將刀具瞬移到新位置 |
— |
PlayClTeleport |
將刀具瞬移到指定 CL 位置與方位 |
— |
設定 — 解析度
| 命令 |
說明 |
用於 |
MachiningResolution_mm |
設定工件實體解析度（2 次方的立方體寬度，mm） |
基礎仿真 |
DispCache_Mb |
設定顯示快取大小（Mb） |
基礎仿真 |
MachiningMotionResolution |
設定加工運動解析度模式 |
基礎仿真 |
設定 — 物理計算
| 命令 |
說明 |
用於 |
EnablePhysics |
啟用／停用銑削力評估 |
銑削力參數訓練、NC 優化 |
EnableWearEffect |
啟用／停用刀具磨耗效應 |
— |
MillingForceCycleDivisionNum |
力計算的每轉分割數 |
銑削力參數訓練 |
InitSpindleTemperature_C |
初始主軸溫度 (°C) |
— |
EnablePauseOnFailure |
失敗時暫停執行 |
幾何驗證 |
EnableCollisionDetection |
啟用碰撞檢測 |
幾何驗證 |
EnablePauseOnCollision |
碰撞時暫停 |
幾何驗證 |
資料匯出
| 命令 |
說明 |
用於 |
WriteShotFiles |
以給定時間解析度匯出波形（shot）資料 CSV |
銑削力參數訓練 |
WriteStepFiles |
匯出步級資料 CSV |
基礎仿真、銑削力參數訓練 |
資料映射
| 命令 |
說明 |
用於 |
MapSingleByCsvFile |
由 CSV 做一對一時間插值映射 |
感測器映射 |
MapSeriesByCsvFile |
由 CSV 做一對多時間序列映射（透過 ActualTime） |
感測器映射 |
AddTimeDataByFile |
為局部映射指定輸入資料與時間範圍 |
感測器映射、銑削力參數訓練 |
ClearTimeMappingData |
清除所有映射資料 |
感測器映射 |
BeginSelection |
設定範圍映射起點（NC 註解內） |
感測器映射 |
EndSelection |
設定範圍映射終點（NC 註解內） |
感測器映射 |
LineSelection |
單行資料映射（NC 註解內） |
感測器映射 |
EnableMapOnSelectionEnd |
選擇結束時自動觸發映射（預設 true） |
感測器映射 |
訓練
| 命令 |
說明 |
用於 |
TrainMillingPara |
由映射資料訓練全新銑削係數 |
銑削力參數訓練 |
ReTrainMillingPara |
校正既有銑削係數（10% 原有 / 90% 新樣本） |
銑削力參數訓練 |
LoadCuttingParaByFile |
由檔案載入切削參數至工件 |
銑削力參數訓練 |
MillingCycleDivisionNum |
每轉的角度分割數 |
銑削力參數訓練 |
優化
| 命令 |
說明 |
用於 |
OptimizeToFiles |
輸出優化 NC 檔 |
NC 優化 |
OptEnableFeedrate |
啟用循序進給率優化 |
NC 優化 |
OptEnableInterpolation |
啟用重新插補 |
NC 優化 |
OptFeedrateAssignmentRatio |
重新插補的進給率分配比例 |
NC 優化 |
OptRapidFeed_mmdmin |
非切削區進給率 (mm/min) |
NC 優化 |
OptMinFeedrate_mmdmin |
切削區最小進給率 (mm/min) |
NC 優化 |
OptMaxFeedrate_mmdmin |
切削區最大進給率 (mm/min) |
NC 優化 |
OptMaxAcceleration_mmds2 |
加減速上限 (mm/s²) |
NC 優化 |
OptExtendedPreDistance_mm |
切削區計算前置距離 (mm) |
NC 優化 |
OptExtendedPostDistance_mm |
切削區計算後置距離 (mm) |
NC 優化 |
OptSpindlePowerSafetyFactor |
主軸功率安全係數 |
NC 優化 |
OptSpindleTorqueSafetyFactor |
主軸力矩安全係數 |
NC 優化 |
OptThermalYieldSafetyFactor |
熱屈服安全係數 |
NC 優化 |
OptPreferedForce_N |
目標切削力 (N) |
NC 優化 |
Preserve |
為單一 NC 行停用優化 |
NC 優化 |
BeginPreserve |
開始優化停用區段 |
NC 優化 |
EndPreserve |
結束優化停用區段 |
NC 優化 |
EnableIndividualStepAdjustmentLog |
啟用步級優化日誌檔 |
NC 優化 |
EmbeddedLogMode |
設定嵌入日誌詳細度（None / SimpleLog / FullLog） |
NC 優化 |
幾何
| 命令 |
說明 |
用於 |
WriteRuntimeGeom |
將運行時幾何儲存至檔案 |
基礎仿真 |
ReadRuntimeGeom |
從檔案載入運行時幾何 |
基礎仿真 |
WriteRuntimeGeomToStl |
將運行時幾何匯出為 STL |
基礎仿真 |
WriteRuntimeGeomToObj |
將運行時幾何匯出為 Wavefront OBJ（逐頂點 RGB） |
基礎仿真 |
WriteRuntimeGeomToPly |
將運行時幾何匯出為二進位 PLY（逐頂點 RGB） |
基礎仿真 |
Diff |
比對仿真幾何與目標幾何 |
幾何驗證 |
RemoveFlyPiece |
移除未連接殘料 |
幾何驗證 |
ScanRuntimeGeomInfDefect |
掃描無限邊切削缺陷 |
幾何驗證 |
ClearDefectDisplayee |
清除缺陷視覺標記 |
幾何驗證 |
事件
| 命令 |
說明 |
用於 |
SessionStepBuilt |
加工步建構完成時觸發 |
NC 優化 |
SessionStepSelected |
加工步被選取時觸發 |
— |
訊息
| 命令 |
說明 |
用於 |
Message |
顯示一般訊息 |
所有工作流程 |
ProgressMessage |
顯示進度訊息 |
所有工作流程 |
WarningMessage |
顯示警告訊息 |
所有工作流程 |
ErrorMessage |
顯示錯誤訊息 |
所有工作流程 |
AppendMessagesToFile |
將訊息匯出至檔（可選標籤過濾） |
所有工作流程 |
SessionProgress |
工作階段訊息主體物件 |
SessionProgress |
步資料存取
| 命令 |
說明 |
用於 |
GetMillingStep |
依索引取得步 |
基礎仿真 |
StepCount |
步總數 |
基礎仿真 |
RegisterStepVariable |
註冊自訂步變數 |
步 (Step) |
運行時管理
| 命令 |
說明 |
用於 |
ResetRuntime |
清除事件處理器、緩衝區與運行時狀態 |
基礎仿真 |
MachiningSession |
取得當前加工 session 物件 |
— |
屬性 — 工件與夾具
| 命令 |
說明 |
用於 |
Workpiece |
取得／設定工件物件 |
基礎仿真 |
Fixture |
取得／設定夾具物件 |
基礎仿真 |
Global |
跨腳本資料共享的全域變數字典 |
腳本命令 |
刀具設置
| 命令 |
說明 |
用於 |
GetUniformContourTrayShiftAngle_deg |
取得刀具輪廓位移角 (deg) |
— |
SetUniformContourTrayShiftAngle_deg |
設定刀具輪廓位移角 (deg) |
— |
GetStickMachiningToolObservationHeight_mm |
取得智慧刀把觀測高度 (mm) |
— |
SetStickMachiningToolObservationHeight_mm |
設定智慧刀把觀測高度 (mm) |
— |
Note
刀具設置命令用於實際安裝條件偏離預設值時的動態調整。一般而言，請改在刀具設定檔中配置。
延伸閱讀