解决 3CX Windows 软电话问题

介绍

由于不同的 Microsoft Windows PC 可能具有不同的确切 Windows 版本或升级历史，在极少数情况下，您可能需要采取措施来恢复 3CX 软电话的功能。

本文档涵盖了其中一些较常见的问题及其解决方法。

Windows 问题

软电话启动但停留在后台

如果您的 3CX 软电话成功启动，但没有自动显示在桌面上，请按照以下步骤操作：

  • 首先，导航到：

%localappdata%\Packages\3CXDMCC.3CX_97f1hnz6y6tba\LocalCache\Local\3CXSoftphone

或

%localappdata%\Packages\3CXDMCC.3CX_bhm4yemhnd70e\LocalCache\Local\3CXSoftphone

或  

%localappdata%\Packages\3CXDMCC.3CXBeta_bhm4yemhnd70e\LocalCache\Local\3CXSoftphone

  • 然后打开 .log 文件。
  • 检查日志文件中是否有如下所示的行，请注意，您必须查找当前的软电话版本字符串，例如 "release-V5.6"。

[FTL|2|_3CXSoftphone.App] UNHANDLED EXCEPTION

System.IO.FileNotFoundException: The specified module could not be found. (0x8007007E)

   at System.Runtime.InteropServices.Marshal.ThrowExceptionForHR(Int32 errorCode)

   at WinRT.ActivationFactory.Get(String typeName)

   at Windows.Media.Playback.MediaPlayer.get__objRef_global__Windows_Media_Playback_MediaPlayer()

   at Windows.Media.Playback.MediaPlayer..ctor()

   at _3CXSoftphone.Telephony.Ringtone.RingtonePlayerImpl..ctor(ILoggerFactory loggerFactory, IAudioDeviceSource audioDeviceSource, ISettingsService settingsService) in C:\_\workspace\3CXPhone\softphone\release-V5.6\app\3CXSoftphone\Telephony\Ringtone\RingtonePlayerImpl.cs:line 31

如果显示此异常，请执行以下操作：

  • 点击开始 > 运行， 输入 optionalfeatures 并按 确定
  • 选择 媒体功能
  • 展开并确保旧版 Windows Media Player （应用）也被选中
  • 点击 确定 按钮
  • 过程完成后，重启电脑。
  • 如果以上步骤无效，您仍然遇到相同的错误，请以管理员身份打开 PowerShell 并运行以下命令：

                

Get-WindowsCapability -online | Where-Object -Property name -like "*media*" | Add-WindowsCapability -Online

  • 重新启动电脑。

软电话启动后立即终止

如果您的软电话看似正常启动，但随后立即关闭，请按照以下步骤解决问题：

  • 首先，检查事件查看器：
  • 扩张 应用程序和服务日志 > Microsoft > Windows > AppxDeploymentServer > Microsoft-Windows-AppxDeploymentServer/Operational
  • 检查是否你会看到类似这样的条目：

        

MicrosoftCorporationII.WinAppRuntime.Singleton_8000.921.1539.0_x64__8wekyb3d8bbwe :

C:\Program Files\WindowsApps\MicrosoftCorporationII.WinAppRuntime.Singleton_8000.921.1539.0_x64__8wekyb3d8bbwe\microsoft.system.package.metadata\S-1-5-21-...-MergedResources-*.pri :

No user-specific merged files found

您可以通过以下步骤进一步确认此问题正是需要解决的问题：

  • 确认以管理员身份启动软电话工作正常；
  • 问题具体出现在标准用户会话中。
  • 记下你的WindowsAppRuntime Singleton 版本；在PowerShell中运行以下命令：

Get-AppxPackage -Name "*WinAppRuntime.Singleton*" | Select-Object Name, Version, PackageFullName

  • 将其与下表匹配，并在 Google 上搜索 Windows App SDK + 版本，然后从 Microsoft下载可再发行组件 (ZIP) 包：

Singleton Version

Windows App Runtime Version

7000.xxx.xxxx.x

Windows App SDK 1.7

8000.xxx.xxxx.x

Windows App SDK 1.8

  • 解压缩 ZIP 文件并导航到：
  • /{解压文件夹}/MSIX/win10-x64
  • 执行下面显示的两个步骤：
  • 以 管理员 身份，将 Singleton .msix 文件复制到您的个人 Downloads 文件夹，然后
  • 在具有管理员权限的 PowerShell 中运行以下命令：

对于 Windows App SDK 1.7

$path = "$env:USERPROFILE\Downloads\Microsoft.WindowsAppRuntime.Singleton.1.7.msix"

Add-AppxProvisionedPackage -Online -PackagePath $path -SkipLicense -LogPath "C:\Temp\Singleton_Provision.log"

对于 Windows App SDK 1.8

$path = "$env:USERPROFILE\Downloads\Microsoft.WindowsAppRuntime.Singleton.1.8.msix"

Add-AppxProvisionedPackage -Online -PackagePath $path -SkipLicense -LogPath "C:\Temp\Singleton_Provision.log"

  • 完成后，以遇到软电话启动问题的用户身份重新登录 Windows，在非管理员模式下，在 PowerShell 中运行以下命令：

Add-AppxPackage -RegisterByFamilyName -MainPackage "MicrosoftCorporationII.WinAppRuntime.Singleton_8wekyb3d8bbwe" -Verbose

  • 关闭并重新启动 3CX 软电话（以受影响的用户身份），以确认它现在可以正常启动。

另请参阅

最后更新时间
本文件最后更新日期为2026年7月28日。
https://www.3cx.cn/docs/troubleshoot-softphone/