Files
MusicDownloader/MusicDownloader/Class/CmnUtil.cs
T

373 lines
17 KiB
C#
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
using System;
using System.IO;
using System.Text.RegularExpressions;
namespace MusicDownloader.Class
{
/// <summary>
/// 汎用ユーティリティクラス
/// </summary>
public static class CmnUtil
{
private static readonly char[] InvalidPathChars = Path.GetInvalidFileNameChars();
/// <summary>
/// ファイル名として利用できない文字(\ / : * ? " < > | および制御文字)を、
/// 自然で安全な全角文字や代替文字に変換・整形する
/// </summary>
public static string SanitizeFileName(string name)
{
if (string.IsNullOrWhiteSpace(name))
{
return "Unknown";
}
var clean = name;
// Windowsおよびファイルシステムで使用禁止の記号を全角文字に変換
clean = clean
.Replace('\\', '¥')
.Replace('/', '/')
.Replace('\u29F8', '/') // Linuxでyt-dlpが置換する ⧸ (BIG SOLIDUS)
.Replace(':', ':')
.Replace('*', '*')
.Replace('?', '?')
.Replace('"', '”')
.Replace('<', '<')
.Replace('>', '>')
.Replace('|', '|');
// それ以外のシステム予約無効文字(制御文字 0x00〜0x1F など)を除去
foreach (var c in InvalidPathChars)
{
clean = clean.Replace(c.ToString(), "");
}
// 前後の空白やWindowsで問題になる末尾のピリオドを除去
clean = clean.Trim().TrimEnd('.');
// Windowsのデバイス予約名(CON, PRN, AUX, NUL, COM1〜9, LPT1〜9)との衝突回避
var reservedNames = new[] { "CON", "PRN", "AUX", "NUL", "COM1", "COM2", "COM3", "COM4", "COM5", "COM6", "COM7", "COM8", "COM9", "LPT1", "LPT2", "LPT3", "LPT4", "LPT5", "LPT6", "LPT7", "LPT8", "LPT9" };
foreach (var res in reservedNames)
{
if (clean.Equals(res, StringComparison.OrdinalIgnoreCase))
{
clean += "_";
break;
}
}
return string.IsNullOrWhiteSpace(clean) ? "Unknown" : clean;
}
/// <summary>
/// YouTubeチャンネル名(アップローダー名)から「 - Topic」などの自動付与サフィックスを除去・整形する
/// </summary>
public static string CleanChannelName(string? uploader)
{
if (string.IsNullOrWhiteSpace(uploader)) return "";
var clean = uploader.Trim();
// "xxx - Topic" や "xxx - トピック" の除去
clean = Regex.Replace(clean, @"\s*[-–—]\s*(?:Topic|トピック)$", "", RegexOptions.IgnoreCase).Trim();
// "xxx Official Channel" などの除去
clean = Regex.Replace(clean, @"\s*(?:Official\s*Channel|Official|公式)$", "", RegexOptions.IgnoreCase).Trim();
return clean;
}
/// <summary>
/// 代表的なVOCAL/アーティスト名やfeat表記を判定する正規表現パターン
/// </summary>
public static readonly Regex VocalOrArtistPattern = new Regex(
@"(?i)\b(?:feat\.?|ft\.?|vocal|vo\.)\b|初音ミク|鏡音リン|鏡音レン|巡音ルカ|MEIKO|KAITO|GUMI|IA|可不|重音テト|flower|歌愛ユキ|星界|裏命|狐子|羽累|ずんだもん|音街ウナ|東北きりたん|Hatsune\s*Miku|Kagamine\s*Rin|Kagamine\s*Len|Megurine\s*Luka|KAFU",
RegexOptions.Compiled);
/// <summary>
/// 動画タイトルから不要な装飾記号・タグ文字列を除去する
/// </summary>
public static string CleanVideoTitle(string rawTitle)
{
if (string.IsNullOrWhiteSpace(rawTitle)) return "";
var cleaned = rawTitle;
// 【MV】, [Official Video], (Audio), 【オリジナル曲】などの装飾カッコを除去
cleaned = Regex.Replace(cleaned, @"(?i)[\(\[\{【「『](?:MV|Music\s*Video|Official(?:\s*Music\s*Video|\s*Video|\s*Audio)?|Audio|Full|Cover|歌ってみた|オリジナル(?:曲)?|HQ|HD|4K|Lyric(?:\s*Video)?|Short\s*ver|Special\s*ver)[^\]\)\}】」』]*[\)\]\}】」』]", "", RegexOptions.Compiled).Trim();
// カッコ外に残った "Official Music Video", "Music Video", "MV" 等の単独テキストを除去
cleaned = Regex.Replace(cleaned, @"(?i)\b(?:Official\s*Music\s*Video|Official\s*Video|Official\s*Audio|Music\s*Video|MV)\b", "", RegexOptions.Compiled).Trim();
// 末尾に残った " - (英語表記/副題)" の除去 (例: " - (From Tokyo / Hatsune Miku)")
cleaned = Regex.Replace(cleaned, @"\s*[-–—]\s*\([^\)]+\)$", "", RegexOptions.Compiled).Trim();
// 末尾や先頭に残った不要なハイフンやスラッシュを除去
cleaned = Regex.Replace(cleaned, @"^[\s\-–—//||\u29F8]+|[\s\-–—//||\u29F8]+$", "", RegexOptions.Compiled).Trim();
return cleaned;
}
/// <summary>
/// YouTube動画のタイトルとアップローダー名から、アーティスト名と曲名を高度に推測・抽出する
/// </summary>
public static (string Artist, string Title) ParseArtistAndTitle(string rawTitle, string uploader)
{
var cleanUploader = CleanChannelName(uploader);
if (string.IsNullOrWhiteSpace(rawTitle))
{
return (!string.IsNullOrWhiteSpace(cleanUploader) ? cleanUploader : "Unknown", "Unknown");
}
// 1. カッコによる曲名囲みパターン: アーティスト「曲名」 または アーティスト『曲名』
var bracketMatch = Regex.Match(rawTitle, @"^(.*?)\s*[「『""]([^「『""」』]+)[」』""]\s*(.*)$", RegexOptions.Compiled);
if (bracketMatch.Success)
{
var candidateArtist = bracketMatch.Groups[1].Value.Trim();
var candidateTitle = bracketMatch.Groups[2].Value.Trim();
candidateArtist = CleanVideoTitle(candidateArtist);
candidateTitle = CleanVideoTitle(candidateTitle);
// アーティスト候補が空の場合、アップローダーを適用
if (string.IsNullOrWhiteSpace(candidateArtist) && !string.IsNullOrWhiteSpace(cleanUploader))
{
candidateArtist = cleanUploader;
}
if (!string.IsNullOrWhiteSpace(candidateArtist) && !string.IsNullOrWhiteSpace(candidateTitle))
{
return (candidateArtist, candidateTitle);
}
}
// 2. 装飾記号を除去したクリーンタイトルを生成
var cleaned = CleanVideoTitle(rawTitle);
// 3. 区切り記号(ハイフン、スラッシュ、パイプ、BIG SOLIDUS等)で分割判定
var match = Regex.Match(cleaned, @"^(.*?)\s*([-–—//||\u29F8])\s*(.*)$", RegexOptions.Compiled);
if (match.Success)
{
var part1 = match.Groups[1].Value.Trim();
var sep = match.Groups[2].Value.Trim();
var part2 = match.Groups[3].Value.Trim();
// 各パートの前後に残ったハイフンや装飾・カッコの整理
part1 = CleanVideoTitle(part1).Trim(' ', '-', '–', '—', '/', '/', '|', '|', '\u29F8');
part2 = CleanVideoTitle(part2).Trim(' ', '-', '–', '—', '/', '/', '|', '|', '\u29F8');
part1 = Regex.Replace(part1, @"\s*[-–—]\s*(\([^\)]+\))?$", "").Trim();
part2 = Regex.Replace(part2, @"\s*[-–—]\s*(\([^\)]+\))?$", "").Trim();
if (!string.IsNullOrEmpty(part1) && !string.IsNullOrEmpty(part2))
{
// A. チャンネル名と照合
if (!string.IsNullOrWhiteSpace(cleanUploader))
{
if (part2.Equals(cleanUploader, StringComparison.OrdinalIgnoreCase) ||
part2.Contains(cleanUploader, StringComparison.OrdinalIgnoreCase))
{
return (cleanUploader, part1);
}
if (part1.Equals(cleanUploader, StringComparison.OrdinalIgnoreCase) ||
part1.Contains(cleanUploader, StringComparison.OrdinalIgnoreCase))
{
return (part1, part2);
}
}
// B. ボーカル名・アーティスト名特有のキーワード判定(初音ミク等)
var isPart1Vocal = VocalOrArtistPattern.IsMatch(part1);
var isPart2Vocal = VocalOrArtistPattern.IsMatch(part2);
if (isPart2Vocal && !isPart1Vocal)
{
// 「曲名 / ボーカル」パターン (例: フロムトーキョー / 初音ミク)
return (part2, part1);
}
if (isPart1Vocal && !isPart2Vocal)
{
// 「ボーカル - 曲名」パターン
return (part1, part2);
}
// C. 区切り文字に応じた判定
// スラッシュ区切り(/、/、⧸)の場合は「曲名 / アーティスト」のパターンが多い
if (sep == "/" || sep == "/" || sep == "\u29F8")
{
return (part2, part1);
}
// ハイフン等の場合は既定で「Artist - Title」と仮定
return (part1, part2);
}
}
// 4. 区切りがない場合はアップローダーをアーティスト、タイトルを曲名とする
var finalArtist = !string.IsNullOrWhiteSpace(cleanUploader) ? cleanUploader : "Unknown";
var finalTitle = !string.IsNullOrWhiteSpace(cleaned) ? cleaned : rawTitle;
return (finalArtist, finalTitle);
}
/// <summary>
/// 2つの曲名が確実に同一の楽曲であると判別できるかを厳密に判定する
/// (全角半角・大文字小文字・装飾括弧・不要なタグの差異を吸収してコア曲名が一致するか検証)
/// </summary>
public static bool IsConfidentTitleMatch(string? originalTitle, string? candidateTitle)
{
if (string.IsNullOrWhiteSpace(originalTitle) || string.IsNullOrWhiteSpace(candidateTitle))
{
return false;
}
var coreOrig = ExtractCoreTitle(originalTitle);
var coreCand = ExtractCoreTitle(candidateTitle);
if (string.IsNullOrWhiteSpace(coreOrig) || string.IsNullOrWhiteSpace(coreCand))
{
return false;
}
// 1. 完全一致(大文字小文字無視)
if (string.Equals(coreOrig, coreCand, StringComparison.OrdinalIgnoreCase))
{
return true;
}
// 2. 空白・全角半角記号をすべて除去して比較
var strippedOrig = NormalizeForComparison(coreOrig);
var strippedCand = NormalizeForComparison(coreCand);
if (strippedOrig.Length > 0 && strippedOrig == strippedCand)
{
return true;
}
// 3. 一方がもう一方と前方一致かつ十分な長さがある場合
if (strippedOrig.Length >= 3 && strippedCand.Length >= 3)
{
if (strippedOrig.StartsWith(strippedCand, StringComparison.OrdinalIgnoreCase) ||
strippedCand.StartsWith(strippedOrig, StringComparison.OrdinalIgnoreCase))
{
return true;
}
}
return false;
}
/// <summary>
/// タイトル文字列から装飾記号・バージョン表記(MV, Official, feat.等)を除去し、楽曲の本質的なコアタイトルを抽出する
/// </summary>
public static string ExtractCoreTitle(string title)
{
if (string.IsNullOrWhiteSpace(title)) return "";
var clean = title;
// カッコ内表記((feat. xxx), (Off Vocal), (TV Size), [Official Video] 等)を除去
clean = Regex.Replace(clean, @"(?i)[\(\[\{【「『](?:feat\.?|ft\.?|off\s*vocal|instrumental|inst|tv\s*size|short\s*ver|mv|official|cover|歌ってみた|remix|acoustic|ver\.?)[^\]\)\}】」』]*[\)\]\}】」』]", "", RegexOptions.Compiled);
// 単独の装飾カッコの除去
clean = Regex.Replace(clean, @"(?i)[\(\[\{【「『][^\]\)\}】」』]*[\)\]\}】」』]", "", RegexOptions.Compiled);
// 不要なハイフン以降(- Instrumental 等)
clean = Regex.Replace(clean, @"(?i)\s*[-–—//]\s*(?:instrumental|inst|off\s*vocal|tv\s*size|remix|cover|acoustic).*$", "", RegexOptions.Compiled);
// CleanVideoTitle を通す
clean = CleanVideoTitle(clean);
return clean.Trim();
}
/// <summary>
/// 比較用に英数字を小文字化し、記号や空白を取り除いた文字列を生成
/// </summary>
private static string NormalizeForComparison(string text)
{
if (string.IsNullOrWhiteSpace(text)) return "";
// 空白および記号文字の除去
return Regex.Replace(text, @"[\s\p{P}\p{S}]+", "").ToLowerInvariant();
}
/// <summary>
/// 候補アーティスト名が、動画タイトル、推測アーティスト、またはアップローダー名と確実に一致しているかを厳密に判定する
/// (アーティスト名が動画情報に一切登場しない別名義・別アーティストによる誤ったメタデータ埋め込みを防止)
/// </summary>
public static bool IsConfidentArtistMatch(
string? expectedArtist,
string? candidateArtist,
string? rawVideoTitle,
string? uploader)
{
if (string.IsNullOrWhiteSpace(candidateArtist))
{
return false;
}
var candNorm = NormalizeForComparison(candidateArtist);
if (string.IsNullOrWhiteSpace(candNorm))
{
return false;
}
// 1. 推測されたアーティスト名との直接照合
if (!string.IsNullOrWhiteSpace(expectedArtist) && expectedArtist != "Unknown")
{
var expNorm = NormalizeForComparison(expectedArtist);
if (!string.IsNullOrWhiteSpace(expNorm))
{
if (expNorm == candNorm) return true;
if (expNorm.Length >= 2 && candNorm.Length >= 2)
{
if (expNorm.Contains(candNorm) || candNorm.Contains(expNorm))
{
return true;
}
}
}
}
// 2. アップローダー名(チャンネル名)との照合
if (!string.IsNullOrWhiteSpace(uploader))
{
var upNorm = NormalizeForComparison(CleanChannelName(uploader));
if (!string.IsNullOrWhiteSpace(upNorm))
{
if (upNorm == candNorm) return true;
if (upNorm.Length >= 2 && candNorm.Length >= 2)
{
if (upNorm.Contains(candNorm) || candNorm.Contains(upNorm))
{
return true;
}
}
}
}
// 3. 動画タイトル全体(rawVideoTitle)との照合
if (!string.IsNullOrWhiteSpace(rawVideoTitle))
{
var titleNorm = NormalizeForComparison(rawVideoTitle);
// 候補アーティスト名がタイトル内に含まれているか
if (candNorm.Length >= 2 && titleNorm.Contains(candNorm))
{
return true;
}
}
return false;
}
/// <summary>
/// 例外スタックトレースをログ出力
/// </summary>
public static void PrintCallStackToEvent(Exception? ex)
{
if (ex == null) return;
LogManager.AddError($"未処理の例外が発生しました: {ex.Message}", ex);
}
}
}