70 lines
2.8 KiB
C#
70 lines
2.8 KiB
C#
// Copyright (c) 2025 Vuplex Inc. All rights reserved.
|
|
//
|
|
// Licensed under the Vuplex Commercial Software Library License, you may
|
|
// not use this file except in compliance with the License. You may obtain
|
|
// a copy of the License at
|
|
//
|
|
// https://vuplex.com/commercial-library-license
|
|
//
|
|
// Unless required by applicable law or agreed to in writing, software
|
|
// distributed under the License is distributed on an "AS IS" BASIS,
|
|
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
// See the License for the specific language governing permissions and
|
|
// limitations under the License.
|
|
using System;
|
|
|
|
namespace Vuplex.WebView {
|
|
|
|
/// <summary>
|
|
/// An interface implemented by a webview if it supports file downloads.
|
|
/// </summary>
|
|
/// <remarks>
|
|
/// When downloads are enabled enabled, files are downloaded to Application.temporaryCachePath, but you can move them to a different
|
|
/// location after they finish downloading.
|
|
/// </remarks>
|
|
/// <remarks>
|
|
/// On iOS, downloads are only supported on iOS 14.5 or newer because older versions of iOS lack download support.
|
|
/// On versions of iOS older than 14.5, enabling downloads has no effect.
|
|
/// </remarks>
|
|
/// <example>
|
|
/// <code>
|
|
/// await webViewPrefab.WaitUntilInitialized();
|
|
/// var webViewWithDownloads = webViewPrefab.WebView as IWithDownloads;
|
|
/// if (webViewWithDownloads == null) {
|
|
/// Debug.Log("This 3D WebView plugin doesn't yet support IWithDownloads: " + webViewPrefab.WebView.PluginType);
|
|
/// return;
|
|
/// }
|
|
/// webViewWithDownloads.SetDownloadsEnabled(true);
|
|
/// webViewWithDownloads.DownloadProgressChanged += (sender, eventArgs) => {
|
|
/// Debug.Log(
|
|
/// $@"DownloadProgressChanged:
|
|
/// Type: {eventArgs.Type},
|
|
/// Url: {eventArgs.Url},
|
|
/// Progress: {eventArgs.Progress},
|
|
/// Id: {eventArgs.Id},
|
|
/// FilePath: {eventArgs.FilePath},
|
|
/// ContentType: {eventArgs.ContentType}"
|
|
/// );
|
|
/// if (eventArgs.Type == ProgressChangeType.Finished) {
|
|
/// Debug.Log("Download finished");
|
|
/// // Now that the file has finished downloading, do something with it.
|
|
/// // For example, you can move it to a different location.
|
|
/// File.Move(eventArgs.FilePath, someOtherLocation);
|
|
/// }
|
|
/// };
|
|
/// </code>
|
|
/// </example>
|
|
public interface IWithDownloads {
|
|
|
|
/// <summary>
|
|
/// Sets whether file downloads are enabled. The default is disabled.
|
|
/// </summary>
|
|
void SetDownloadsEnabled(bool enabled);
|
|
|
|
/// <summary>
|
|
/// Indicates that the progress of a file download changed.
|
|
/// </summary>
|
|
event EventHandler<DownloadChangedEventArgs> DownloadProgressChanged;
|
|
}
|
|
}
|