[RMXP] Hangup 异常根除


通用 FSL 信息

脚本说明

灼眼的夏娜曾经发布过一个解决 RMXP 10 秒不刷新就抛出 Hangup 异常，提示“脚本已备份”（这个错误信息是汉化失误）问题的脚本，其原理是创建一个 Ruby 线程，定期调用 Graphics.update，这样就能防止异常的抛出。这个解决方法有一个弊端，就是当 RM 进程阻塞时，Ruby 线程也会停止运行，超过 10 秒后仍如果进程从阻塞中恢复，仍然会抛出 Hangup 异常。我们自然而然地会想：难道不能从根本杜绝 Hangup 的抛出吗？

前不久在写精确获取窗口句柄的时候，发现 RMXP 游戏进程创建了不止一个的 Windows 线程，通过一个一个地结束线程发现，游戏进程最后创建的一个线程恰好就是控制 Hangup 异常抛出的线程。估计 10 秒的计时也是在这个线程内部的用户代码中进行的。那我们简单地、暴力地把这个线程咔嚓掉，不就搞定了吗？我这么做了，结果发现：原来处理程序最终化（即退出时）的也是这个线程，在我把这个线程咔嚓之后，无论是点窗口右上角的关闭按钮，所有脚本都解释完毕，还是在异常抛出到 Ruby 顶层后的正常退出都失效了，只能通过结束进程来关闭游戏。

想了几天，终于想到了解决方法：在程序初始化的时候就暂停掉这个线程，直到游戏需要退出的时候再恢复其用户代码的运行，这样，游戏过程中所有本来应该抛出 Hangup 异常的地方都被鞋盒掉了，这就是这个脚本的暴力之处。但关键就是——怎么在所有需要退出的场合下都进行线程的恢复？点窗口关闭按钮的场合很容易，可以重新定义 exit；所有脚本解释完毕的场合也很容易，可以在 main 脚本下面做相关的处理；而异常抛出到顶层的场合，似乎就不那么么简单了。你说可以在 main 脚本的 begin … rescue … end 那里捕获其它所有异常？那万一在前面定义 Game_Temp 啊 Scene_Title 啊之类的地方发生了异常（也就是解释到 main 脚本之前）怎么办呢？

现在的办法是这样的：游戏运行的时候，RM 会把脚本读取到一个全局数组 $RGSS_SCRIPTS 中，而实际在解释脚本的时候也是在访问这个数组的内容。我们可以越俎代庖，在 RM 解释所有脚本之前（不包括越俎代庖的这个脚本）先把脚本解释完了，然后直接退出程序。换句话说，就是通过 Ruby 的 eval 函数去代替了 RM 的 RGSSEval 函数，解释了所有的脚本。这样一来，在解释脚本过程中所有的异常（当然也不包括越俎代庖脚本中的异常，下面发布是经过调试后的脚本，应该不会有错误了，不过为了保险起见还望大家多多测试）都可以通过 rescue 来捕获到了！当然有利也有弊，这样做了之后，当异常抛出时，提示的消息就只有“eval:#{出错行数}#{出错信息}”，而没有为用户提供脚本的标题，并在脚本编辑器中把光标指向出错的地方了，这是这个脚本的副作用。

当然，发生错误的时候你完全可以暂时屏蔽掉这个脚本，这样就可以把异常后的效果恢复到从前那样了，反正调试的时候你也不一定需要这个脚本。另外，这个脚本在捕获到异常，恢复了线程的运行之后就直接把异常再次抛出给了顶层，所以异常错误信息没有脚本的标题。但其实在循环中，完全可以通过 $RGSS_SCRIPT[subscript] 的第二个元素获取到当前的脚本标题，有心人可以自己改一下，让脚本弹出消息框告诉你这些信息，而不是直接交给 RM 的异常处理机制来处理。

最后，这个脚本完全有可能引起未知的问题，因为被屏蔽掉的线程对我们普通 RM 用户来说还是未知的，万一它还处理了什么其它的东西呢？我们还需要更多的测试。

更新历史

  • 1.2.0827 By 紫苏

    • 更改了配置模块名
    • 更改了 FSL 注释信息
  • 1.2.0805 By 紫苏

    • 脚本开始遵循 FSL
    • 全局范围内改变了脚本结构
  • 1.1.1101 By 紫苏

    • 修正了脚本在 Windows XP 平台下失效的问题
  • 1.0.0927 By 紫苏

    • 初始版本完成

脚本源码

#==============================================================================
# ■  Hangup 异常根除
#    Hangup Exception Eradication
#----------------------------------------------------------------------------
#
#    Hangup 异常是 RMXP 底层引擎内置的一个异常类，游戏进程会在 Graphics.update
#    没有调用超过 10 秒时抛出这个异常。这个脚本使用了 Windows API 暴力地解除
#    了这个限制。
#    使用方法：Hangup 异常根除脚本必须插入到脚本编辑器的最顶端，所有脚本之前，无
#    例外。
#
#----------------------------------------------------------------------------
#
#    更新作者： 紫苏
#    许可协议： FSL -MEE
#    项目版本： 1.2.0827
#    引用网址： 
#    http://bbs.66rpg.com/forum.php?mod=viewthread&tid=134316
#    https://szsu.wordpress.com/2010/08/09/hangup_eradication
#
#----------------------------------------------------------------------------
#
#    - 1.2.0827 By 紫苏
#      * 更改了配置模块名
#      * 更改了 FSL 注释信息
#
#    - 1.2.0805 By 紫苏
#      * 脚本开始遵循 FSL
#      * 全局范围内改变了脚本结构
#
#    - 1.1.1101 By 紫苏
#      * 修正了脚本在 Windows XP 平台下失效的问题
#
#    - 1.0.0927 By 紫苏
#      * 初始版本完成
#
#==============================================================================

$__jmp_here.call if $__jmp_here

#----------------------------------------------------------------------------
# ● 登记 FSL。
#----------------------------------------------------------------------------
$fscript = {} if !$fscript
$fscript['HangupEradication'] = '1.2.0827'

#==============================================================================
# ■ FSL
#------------------------------------------------------------------------------
# 　自由RGSS脚本通用公开协议的功能模块。
#==============================================================================

module FSL
  module HangupEradication
    #------------------------------------------------------------------------
    # ● 定义需要的 Windows API。
    #------------------------------------------------------------------------
    OpenThread = Win32API.new('kernel32', 'OpenThread', 'LIL', 'L')
    CloseHandle = Win32API.new('kernel32', 'CloseHandle', 'L', 'I')
    Thread32Next = Win32API.new('kernel32', 'Thread32Next', 'LP', 'I')
    ResumeThread = Win32API.new('kernel32', 'ResumeThread', 'L', 'L')
    SuspendThread = Win32API.new('kernel32', 'SuspendThread', 'L', 'L')
    Thread32First = Win32API.new('kernel32', 'Thread32First', 'LP', 'I')
    GetCurrentProcessId = Win32API.new('kernel32', 'GetCurrentProcessId', 'V', 'L')
    CreateToolhelp32Snapshot = Win32API.new('kernel32', 'CreateToolhelp32Snapshot', 'LL', 'L')
  end
end

#==============================================================================
# ■ HangupEradication
#------------------------------------------------------------------------------
# 　处理根除 Hangup 异常的类。
#==============================================================================

class HangupEradication
  include FSL::HangupEradication
  #--------------------------------------------------------------------------
  # ● 初始化对像。
  #--------------------------------------------------------------------------
  def initialize
    @hSnapShot = CreateToolhelp32Snapshot.call(4, 0)
    @hLastThread = OpenThread.call(2, 0, self.getLastThreadId)
    #@hLastThread = OpenThread.call(2097151, 0, threadID)
    ObjectSpace.define_finalizer(self, self.method(:finalize))
  end
  #--------------------------------------------------------------------------
  # ● 获取当前进程创建的最后一个线程的标识。
  #--------------------------------------------------------------------------
  def getLastThreadId
    threadEntry = [28, 0, 0, 0, 0, 0, 0].pack("L*")
    threadId = 0                                          # 线程标识
    found = Thread32First.call(@hSnapShot, threadEntry)   # 准备枚举线程
    while found != 0
      arrThreadEntry = threadEntry.unpack("L*")           # 线程数据解包
      if arrThreadEntry[3] == GetCurrentProcessId.call    # 匹配进程标识
        threadId = arrThreadEntry[2]                      # 记录线程标识
      end
      found = Thread32Next.call(@hSnapShot, threadEntry)  # 下一个线程
    end
    return threadId
  end
  #--------------------------------------------------------------------------
  # ● 根除 Hangup 异常。
  #     2       : “暂停和恢复线程访问权限”代码；
  #     2097151 : “所有可能的访问权限”代码（Windows XP 平台下无效）。
  #--------------------------------------------------------------------------
  def eradicate
    SuspendThread.call(@hLastThread)
  end
  #--------------------------------------------------------------------------
  # ● 恢复 Hangup 异常。
  #--------------------------------------------------------------------------
  def resume
    while ResumeThread.call(@hLastThread) > 1; end        # 恢复最后一个线程
  end
  #--------------------------------------------------------------------------
  # ● 最终化对像。
  #--------------------------------------------------------------------------
  def finalize
    CloseHandle.call(@hSnapShot)
    CloseHandle.call(@hLastThread)
  end
end

hangupEradication = HangupEradication.new
hangupEradication.eradicate

callcc { |$__jmp_here| }                                  # F12 后的跳转标记

#==============================================================================
# ■ 游戏主过程
#------------------------------------------------------------------------------
# 　游戏脚本的解释从这个外壳开始。
#==============================================================================

for subscript in 1...$RGSS_SCRIPTS.size
  begin
    eval(Zlib::Inflate.inflate($RGSS_SCRIPTS[subscript][2]))
  rescue Exception => ex
    # 异常发生并抛出给解释器时恢复线程。
    hangupEradication.resume unless defined?(Reset) and ex.class == Reset
    raise ex
  end
end

hangupEradication.resume
exit

已知 BUG 与冲突

  • 脚本在 Windows XP 平台下失效（已修复）
This entry was written by Su, posted on 2010/08/09 at 03:24, filed under Ruby, Windows and tagged , . Bookmark the permalink. Follow any comments here with the RSS feed for this post. Post a comment or leave a trackback: Trackback URL.

Leave a comment