Обработка ошибок (пакет SDK для Медиаплеер Windows)
Элемент управления Медиаплеер Windows 6.4 ActiveX обеспечивает обработку ошибок по умолчанию, отображая сообщения об ошибках в диалоговых окнах и в строке состояния. Вы также можете предоставить пользовательскую обработку ошибок, обрабатывая ошибки в скрипте. Обработка ошибок определяется событием, что означает, что вы получаете уведомление о каждой ошибке и должны решить, как справиться с каждым событием ошибки при возникновении. Дополнительные сведения об обработке ошибок с помощью объектной модели версии 6.4 см. в разделе "Обработка ошибок" руководства по объектной модели проигрывателя версии 6.4, который является частью пакета SDK для Медиаплеер Windows.
Объектная модель Медиаплеер Windows 7 или более поздней версии предоставляет объект Error и объект ErrorItem для обработки ошибок. Эти два объекта работают вместе, чтобы обеспечить механизм обработки ошибок, который обеспечивает полный и гибкий контроль над процессом обработки ошибок. Объект Error предоставляет доступ к коллекции объектов ErrorItem ; каждый объект ErrorItem предоставляет сведения об отдельном сообщении об ошибке.
При возникновении ошибки сведения об ошибке публикуются в очереди ошибок. Очередь представляет собой коллекцию объектов ErrorItem . При добавлении каждой ошибки в очередь она связана с номером индекса (начиная с нуля), который можно использовать для идентификации конкретного объекта ErrorItem . Ошибка. Свойство errorCount извлекает количество ошибок в очереди ошибок. Так как номера индекса основаны на нулях, самая последняя ошибка, опубликованная в очереди, всегда будет иметь значение индекса, равное ошибке. errorCount минус один.
Вы можете создать обработчик событий ошибок для Медиаплеер Windows с помощью скрипта. В следующем JScript примере показано, как получить последний элемент ошибки из очереди ошибок и отобразить код ошибки и описание ошибки с помощью объектной модели Медиаплеер Windows 7 или более поздней версии. Объект Player был создан с идентификатором = "WMP9".
<!-- Create an error event handler for Windows Media Player 7 or later errors. -->
<SCRIPT LANGUAGE = "JScript" FOR = WMP9 EVENT = error()>
// Store the number of errors in the error queue.
var max = WMP9.error.errorCount;
// Retrieve most recent ErrorItem object.
var err = WMP9.error.item(max-1)
// Store the error code number.
var errNum = err.errorCode;
// Store the error description string.
var errDesc = err.errorDescription;
// Build a message string to notify the user.
var msg = "Error number: " + errNum + "\n";
msg += "Error description: " + errDesc;
// Display the message box.
alert(msg);
</SCRIPT>
Объект Error имеет два дополнительных метода, которые можно использовать. Ошибка. Метод clearErrorQueue позволяет удалить все ошибки из очереди ошибок и сбросить номер индекса до нуля. Вы полностью контролируете этот процесс; Вы можете хранить ошибки в очереди до тех пор, пока они должны быть доступны, а затем очистить очередь после завершения обработки ошибок.
Ошибка. Метод webHelp позволяет отображать пользователю самые актуальные сведения об ошибках с помощью Интернета. При вызове этот метод передает всю соответствующую информацию о первой ошибке в очереди (с нулевым индексом) в веб-справку Майкрософт Медиаплеер Windows, которая отображает дополнительные сведения об ошибке в текущем окне браузера.
Связанные темы