/* * Copyright (C) 2021 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * 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. */ package android.os.vibrator; import android.annotation.NonNull; import android.annotation.Nullable; import android.annotation.TestApi; import android.os.Parcel; import android.os.Parcelable; import android.os.VibrationEffect; import android.os.VibratorInfo; import com.android.internal.util.Preconditions; import java.util.Objects; /** * Representation of {@link VibrationEffectSegment} that plays a primitive vibration effect after a * specified delay and applying a given scale. * * @hide */ @TestApi public final class PrimitiveSegment extends VibrationEffectSegment { /** @hide */ public static final float DEFAULT_SCALE = 1f; /** @hide */ public static final int DEFAULT_DELAY_MILLIS = 0; private final int mPrimitiveId; private final float mScale; private final int mDelay; PrimitiveSegment(@NonNull Parcel in) { this(in.readInt(), in.readFloat(), in.readInt()); } /** @hide */ public PrimitiveSegment(int id, float scale, int delay) { mPrimitiveId = id; mScale = scale; mDelay = delay; } public int getPrimitiveId() { return mPrimitiveId; } public float getScale() { return mScale; } public int getDelay() { return mDelay; } @Override public long getDuration() { return -1; } /** @hide */ @Override public boolean areVibrationFeaturesSupported(@NonNull VibratorInfo vibratorInfo) { return vibratorInfo.isPrimitiveSupported(mPrimitiveId); } /** @hide */ @Override public boolean isHapticFeedbackCandidate() { return true; } /** @hide */ @NonNull @Override public PrimitiveSegment resolve(int defaultAmplitude) { return this; } /** @hide */ @NonNull @Override public PrimitiveSegment scale(float scaleFactor) { float newScale = VibrationEffect.scale(mScale, scaleFactor); if (Float.compare(mScale, newScale) == 0) { return this; } return new PrimitiveSegment(mPrimitiveId, newScale, mDelay); } /** @hide */ @NonNull @Override public PrimitiveSegment scaleLinearly(float scaleFactor) { float newScale = VibrationEffect.scaleLinearly(mScale, scaleFactor); if (Float.compare(mScale, newScale) == 0) { return this; } return new PrimitiveSegment(mPrimitiveId, newScale, mDelay); } /** @hide */ @NonNull @Override public PrimitiveSegment applyEffectStrength(int effectStrength) { return this; } /** @hide */ @Override public void validate() { Preconditions.checkArgumentInRange(mPrimitiveId, VibrationEffect.Composition.PRIMITIVE_NOOP, VibrationEffect.Composition.PRIMITIVE_LOW_TICK, "primitiveId"); Preconditions.checkArgumentInRange(mScale, 0f, 1f, "scale"); VibrationEffectSegment.checkDurationArgument(mDelay, "delay"); } @Override public void writeToParcel(@NonNull Parcel dest, int flags) { dest.writeInt(PARCEL_TOKEN_PRIMITIVE); dest.writeInt(mPrimitiveId); dest.writeFloat(mScale); dest.writeInt(mDelay); } @Override public int describeContents() { return 0; } @Override public String toString() { return "Primitive{" + "primitive=" + VibrationEffect.Composition.primitiveToString(mPrimitiveId) + ", scale=" + mScale + ", delay=" + mDelay + '}'; } /** @hide */ @Override public String toDebugString() { return String.format("Primitive=%s(scale=%.2f, delay=%dms)", VibrationEffect.Composition.primitiveToString(mPrimitiveId), mScale, mDelay); } @Override public boolean equals(@Nullable Object o) { if (this == o) return true; if (o == null || getClass() != o.getClass()) return false; PrimitiveSegment that = (PrimitiveSegment) o; return mPrimitiveId == that.mPrimitiveId && Float.compare(that.mScale, mScale) == 0 && mDelay == that.mDelay; } @Override public int hashCode() { return Objects.hash(mPrimitiveId, mScale, mDelay); } @NonNull public static final Parcelable.Creator CREATOR = new Parcelable.Creator() { @Override public PrimitiveSegment createFromParcel(Parcel in) { // Skip the type token in.readInt(); return new PrimitiveSegment(in); } @Override public PrimitiveSegment[] newArray(int size) { return new PrimitiveSegment[size]; } }; }