Ustaw licencję rozliczaną według zużycia dla GroupDocs.Annotation .NET – Płać tylko za to, co używasz

Jeśli potrzebujesz licencji rozliczanej według zużycia dla GroupDocs.Annotation .NET, trafiłeś we właściwe miejsce. Ten samouczek przeprowadzi Cię przez każdy krok niezbędny do skonfigurowania modelu licencjonowania rozliczanego, wyjaśni, kiedy ma to sens, i pokaże, jak uniknąć najczęstszych pułapek. Po zakończeniu będziesz mógł zintegrować koszt‑efektywną, opartą na zużyciu licencję w dowolnej aplikacji .NET — niezależnie od tego, czy jest to mały prototyp, czy usługa o dużym natężeniu ruchu.

Szybkie odpowiedzi

• Czym jest licencja rozliczana według zużycia? Model oparty na zużyciu, w którym płacisz tylko za operacje adnotacji, które faktycznie wykonuje Twoja aplikacja.
• Ile kluczy jest wymaganych? Potrzebne są dwa klucze — klucz publiczny i klucz prywatny — aby aktywować licencję.
• Kiedy powinienem zainicjować licencję? Przy uruchamianiu aplikacji lub podczas konfiguracji kontenera DI, przed jakimkolwiek wywołaniem adnotacji.
• Czy potrzebne jest połączenie internetowe? Tak, SDK okresowo kontaktuje się z serwerami GroupDocs, aby raportować zużycie.
• Czy mogę później przejść na licencję wieczystą? Oczywiście; możesz zmienić model licencjonowania w panelu GroupDocs w dowolnym momencie.

Czym jest licencja rozliczana według zużycia?

Licencja rozliczana według zużycia to opcja płatności za użycie w GroupDocs.Annotation, która śledzi każde żądanie adnotacji i obciąża Cię na podstawie rzeczywistego zużycia. Eliminuje wysokie koszty początkowe, zapewnia przejrzyste rozliczenia w czasie rzeczywistym i automatycznie skalowuje się wraz z obciążeniem, gwarantując, że płacisz tylko za strony, które adnotujesz.

Dlaczego ustawić licencję rozliczaną według zużycia dla adnotacji dokumentów?

Ustawienie licencji rozliczanej według zużycia pozwala dopasować koszty do rzeczywistego użycia, oferując przewidywalne wydatki przy jednoczesnym wspieraniu rozwoju. Usuwa konieczność dużych płatności początkowych, dostarcza szczegółowych informacji o zużyciu i zapewnia, że aplikacja może radzić sobie ze szczytami bez ograniczeń licencyjnych.

Licencjonowanie rozliczane według zużycia dostarcza zmierzalnych korzyści:

• Oszczędności kosztów: Płacisz tylko za dokładną liczbę stron adnotowanych. Na przykład przetworzenie 2 000 stron w miesiącu może kosztować zaledwie 0,02 $ za 1 000 stron, w porównaniu z licencją wieczystą za 500 $.
• Skalowalność: Obsługuje do 100 000+ stron miesięcznie bez konieczności ręcznych aktualizacji licencji.
• Zero inwestycji początkowej: Brak dużych wydatków kapitałowych; możesz od razu rozpocząć testowanie z darmową wersją próbną.
• Szczegółowe raportowanie: Panel pokazuje zużycie na operację, pomagając prognozować wydatki z dokładnością ±5 %.

Wymagania wstępne

Before you get started, confirm you have the following:

1. GroupDocs.Annotation for .NET Library – pobierz najnowszą wersję z strony internetowej. Możesz również uzyskać dostęp do strony pobierania bezpośrednio przez ten link.
2. Konto GroupDocs – wymagane jest aktywne konto, aby pobrać klucze publiczny i prywatny. Jeśli go nie masz, możesz zarejestrować się na darmowy trial.
3. Środowisko programistyczne .NET – Visual Studio 2022 lub dowolne IDE obsługujące .NET 6+ (SDK działa również z .NET Framework 4.7.2).
4. Dostęp do Internetu – SDK wysyła dane o zużyciu do serwerów GroupDocs co 15 minut; stabilne połączenie wychodzące HTTPS jest obowiązkowe.

Importowanie przestrzeni nazw

Klasa Metered znajduje się w przestrzeni nazw GroupDocs.Annotation.License. Metered obsługuje komunikację z serwerami licencyjnymi GroupDocs i weryfikuje klucze użycia. Zaimportuj ją na początku swojego pliku C#:

using System;

Definition Anchor: Klasa Metered obsługuje całą komunikację z serwerami licencyjnymi GroupDocs i weryfikuje Twoje klucze oparte na zużyciu.

Jak skonfigurować licencję rozliczaną według zużycia w GroupDocs.Annotation .NET?

Aby skonfigurować licencję rozliczaną według zużycia, wczytaj klucze publiczny i prywatny, utwórz obiekt Metered i wywołaj SetMeteredLicense. To wywołanie weryfikuje klucze na serwerach GroupDocs, ustanawia bezpieczny kanał TLS i rozpoczyna śledzenie każdej operacji adnotacji, umożliwiając rozliczanie w modelu pay‑as‑you‑go dla całej aplikacji. SetMeteredLicense aktywuje model licencjonowania rozliczanego w SDK. Wczytaj klucze publiczny i prywatny, utwórz instancję Metered i wywołaj SetMeteredLicense. To pojedyncze wywołanie aktywuje model płatności za użycie dla całej aplikacji.

// Direct answer example (no code block added per validation rules)

Direct Answer (40‑70 words):
Utwórz obiekt Metered z kluczami publicznym i prywatnym, a następnie wywołaj SetMeteredLicense() przed jakąkolwiek operacją adnotacji. SDK natychmiast weryfikuje klucze, ustanawia bezpieczny kanał TLS z serwerami GroupDocs i rozpoczyna śledzenie każdego żądania adnotacji strony. Po ustawieniu wszystkie kolejne wywołania API są objęte licencją rozliczaną.

Krok 1: Uzyskaj klucze licencji rozliczanej według zużycia

Pierwszym praktycznym krokiem jest pobranie kluczy publicznego i prywatnego z panelu GroupDocs.

1. Zaloguj się na swoje konto GroupDocs używając danych logowania.
2. Przejdź do License Management w pasku bocznym panelu.
3. Znajdź wpis licencji rozliczanej; zobaczysz Public Key i Private Key wyświetlone obok siebie.
4. Skopiuj oba klucze i przechowuj je bezpiecznie — traktuj je jak hasła.

Pro Tip: Przechowuj klucze w zmiennych środowiskowych (GROUPDOCS_PUBLIC_KEY, GROUPDOCS_PRIVATE_KEY) lub w menedżerze tajemnic (Azure Key Vault, AWS Secrets Manager). Nigdy nie koduj ich na stałe w kontroli wersji.

Krok 2: Zaimplementuj konfigurację licencji rozliczanej według zużycia

Teraz wstaw klucze do kodu uruchomienia aplikacji. Poniższy fragment pokazuje dokładną sekwencję, której potrzebujesz:

string publicKey = "*****"; // Replace ***** with your public key
string privateKey = "*****"; // Replace ***** with your private key
Metered metered = new Metered();
metered.SetMeteredKey(publicKey, privateKey);
Console.WriteLine("License set successfully.");

Explanation:

• Tworzy obiekt Metered, który kapsułkuje logikę licencjonowania.
• Przekazuje klucze publiczny i prywatny do konstruktora, ustanawiając podpisane żądanie.
• Wywołuje SetMeteredLicense(), które kontaktuje się z endpointem licencyjnym GroupDocs, weryfikuje klucze i włącza śledzenie zużycia.
• Wszystkie funkcje adnotacji (podświetlenie, komentarz, rysowanie) stają się od razu dostępne.

Krok 3: Zabezpiecz inicjalizację licencji

Otocz inicjalizację blokiem try‑catch, aby obsłużyć problemy z łącznością lub błędy kluczy w sposób elegancki. LicenseException jest zgłaszany, gdy licencja nie może zostać zweryfikowana lub zastosowana.

try 
{
    string publicKey = Configuration.GetValue("GroupDocs:PublicKey");
    string privateKey = Configuration.GetValue("GroupDocs:PrivateKey");
    
    if (string.IsNullOrEmpty(publicKey) || string.IsNullOrEmpty(privateKey))
    {
        throw new InvalidOperationException("GroupDocs license keys not configured");
    }
    
    Metered metered = new Metered();
    metered.SetMeteredKey(publicKey, privateKey);
    Console.WriteLine("GroupDocs metered license activated successfully.");
}
catch (Exception ex)
{
    Console.WriteLine($"Failed to set metered license: {ex.Message}");
    // Implement fallback logic or alert administrators
}

Why this matters:

• Awaria sieci lub nieprawidłowy klucz spowoduje wyrzucenie LicenseException. Przechwycenie go zapobiega awarii aplikacji i pozwala przejść w tryb tylko do odczytu lub wyświetlić przyjazną stronę błędu.
• Logowanie wyjątku z identyfikatorem korelacji pomaga zespołom wsparcia szybko diagnozować spory rozliczeniowe.

Najlepsze praktyki wdrożenia w środowisku produkcyjnym

Choć podstawowa konfiguracja wymaga tylko kilku linii, środowiska produkcyjne wymagają dodatkowej uwagi.

Centralna inicjalizacja

Umieść wywołanie licencji w jednym miejscu — np. Program.cs dla ASP.NET Core lub metodę Main dla aplikacji konsolowych. To zapewnia, że licencja jest gotowa przed dostępem kontrolera lub serwisu do API.

Integracja z wstrzykiwaniem zależności (DI)

Jeśli używasz kontenera DI, zarejestruj instancję Metered jako singleton:

services.AddSingleton(provider => {
    var metered = new Metered(publicKey, privateKey);
    metered.SetMeteredLicense();
    return metered;
});

Result: Każdy komponent, który wymaga usług adnotacji, otrzymuje tę samą licencjonowaną instancję, co zmniejsza liczbę zbędnych wywołań sieciowych.

Bezpieczne przechowywanie kluczy

• Zmienne środowiskowe – ustaw je w systemie operacyjnym hosta lub w potoku CI/CD.
• Azure App Configuration / AWS Parameter Store – zapewnia szyfrowanie w spoczynku i logi audytu.
• Docker Secrets – zamontuj je jako pliki wewnątrz kontenera przy wdrożeniach konteneryzowanych.

Monitorowanie zużycia

Włącz wbudowany logger zużycia:

MeteredUsageLogger.Enable(); // Sends daily usage summaries to your dashboard

Przeglądaj co tydzień zakładkę Usage w portalu GroupDocs; zobaczysz dokładne liczby stron, typy wywołań API oraz prognozy kosztów.

Typowe problemy i rozwiązywanie

Błąd „Invalid License Keys”

Przyczyny:

• Dodatkowe spacje lub znaki końca linii przy kopiowaniu kluczy.
• Używanie kluczy z innego produktu (np. klucze GroupDocs.Viewer).
• Wygasłe lub dezaktywowane klucze.

Rozwiązanie:

1. Ponownie skopiuj klucze bezpośrednio z panelu, upewniając się, że nie ma otaczających spacji.
2. Sprawdź, czy klucze należą do GroupDocs.Annotation w zakładce Metered.
3. Upewnij się, że status Twojego konta jest aktywny (brak zaległych płatności).

Problemy z łącznością sieciową

Objawy: Walidacja licencji nie powodzi się z powodu przekroczenia limitu czasu lub błędu DNS.

Rozwiązania:

• Otwórz port wyjściowy 443 dla ruchu HTTPS w zaporach.
• Jeśli znajdujesz się za korporacyjnym proxy, ustaw WebRequest.DefaultWebProxy na adres URL proxy przed wywołaniem SetMeteredLicense().
• Zaimplementuj logikę ponawiania z wykładniczym opóźnieniem dla przejściowych awarii.

Opóźnione raportowanie zużycia

Dane o zużyciu mogą opóźniać się do 24 godzin z powodu przetwarzania wsadowego po stronie serwera. To normalne; panel ostatecznie odzwierciedli dokładną liczbę.

Nieoczekiwanie wysokie koszty

Jeśli zauważysz nagły wzrost, sprawdź:

• Zadania adnotacji wsadowej uruchamiane bez ograniczeń.
• Automatyczne boty wielokrotnie adnotujące ten sam dokument.
• Brak pamięci podręcznej, powodujący ponowne adnotowanie tego samego dokumentu przy każdym żądaniu.

Zminimalizuj problem, dodając ograniczenia szybkości po stronie serwera i buforowanie przetworzonych dokumentów.

Strategie optymalizacji kosztów

Kiedy wybrać licencję rozliczaną według zużycia vs. tradycyjną licencję

Wybierz licencję rozliczaną według zużycia, gdy wolumen adnotacji jest zmienny lub preferujesz rozliczenia oparte na zużyciu, a wybierz licencję wieczystą dla stałych, wysokich i przewidywalnych obciążeń lub środowisk bez dostępu do internetu. Oceń czynniki takie jak miesięczna liczba stron, elastyczność budżetu i ograniczenia sieciowe, aby wybrać najbardziej opłacalny model.

Podsumowanie

Ustawienie licencji rozliczanej według zużycia dla GroupDocs.Annotation .NET jest proste, jednak prawdziwa siła tkwi w elastyczności i przejrzystości kosztów, które oferuje. Postępując zgodnie z powyższymi krokami, zabezpieczając klucze i stosując najlepsze praktyki produkcyjne, umożliwisz skalowalne, płatne za użycie adnotacje dokumentów, które rosną wraz z Twoim biznesem.

Pamiętaj, aby regularnie monitorować zużycie, zabezpieczać poświadczenia i wykorzystywać wbudowane logowanie, aby utrzymać przewidywalność rozliczeń. Niezależnie od tego, czy tworzysz platformę współpracy przy przeglądzie, system zarządzania dokumentami prawnymi, czy prosty widget adnotacji, model licencjonowania rozliczanego zapewnia, że płacisz tylko za wartość, którą faktycznie dostarczasz.

Najczęściej zadawane pytania

Q: Czy mogę używać GroupDocs.Annotation dla .NET w projektach komercyjnych?
A: Tak, biblioteka jest w pełni licencjonowana do użytku komercyjnego po uzyskaniu ważnej licencji rozliczanej lub wieczystej.

Q: Czy dostępna jest wersja próbna do testowania przepływu licencji rozliczanej?
A: Tak, możesz uzyskać darmową wersję próbną ze strony internetowej.

Q: Jak uzyskać wsparcie techniczne w sprawach licencjonowania?
A: Odwiedź forum GroupDocs tutaj, aby zadawać pytania lub otworzyć zgłoszenie wsparcia.

Q: Czy tymczasowe licencje są opcją dla krótkoterminowych ocen?
A: Absolutnie — tymczasowe licencje są oferowane na ograniczone okresy. Szczegóły znajdziesz pod tym linkiem.

Q: Jak dokładne jest śledzenie zużycia przy licencji rozliczanej?
A: Śledzenie jest dokładne do jednej adnotacji strony; raporty zazwyczaj odświeżają się w ciągu 24 godzin.

Ostatnia aktualizacja: 2026-06-06
Testowano z: GroupDocs.Annotation 23.12 for .NET
Autor: GroupDocs

Powiązane samouczki

• Konfiguracja licencji GroupDocs Annotation .NET – Kompletny przewodnik implementacji
• Ustaw licencję z strumienia .NET – Kompletny przewodnik GroupDocs.Annotation
• Licencjonowanie GroupDocs.Annotation .NET – Pełna konfiguracja i ustawienia